Cara Mengatasi Push Blocked GitHub dengan Memeriksa Aturan dan Izin Push

Cara mengatasi push blocked GitHub paling cepat adalah membaca pesan error Git sampai selesai, lalu memperbaiki sesuai penyebabnya. Push ke branch yang diproteksi harus lewat Pull Request, secret yang terdeteksi harus dihapus dari commit, dan error izin harus dicek lewat role collaborator serta autentikasi HTTPS atau SSH.

Jangan ubah remote atau paksa push sebelum tahu pemicunya. Git menolak push karena alasan berbeda, dan tiap pesan butuh respons berbeda.

Penyebab Push Blocked Paling Sering di GitHub

GitHub memblokir push melalui aturan repository, bukan karena koneksi gagal. Empat pemicu yang paling umum:

  • Branch protection memblokir push langsung ke main atau branch penting.
  • Push protection menolak commit yang berisi token, API key, atau password.
  • Permission kurang, misalnya akun hanya punya akses baca atau belum ditambah sebagai collaborator.
  • Pre-receive hook organisasi menolak push karena kebijakan commit, ukuran file, atau pemeriksaan khusus.

Baca seluruh output terminal. Baris remote: error: biasanya menyebut aturan yang dilanggar. Setelah itu cek kondisi lokal sebelum bertindak:

git status
git branch --show-current
git remote -v

Perintah itu memastikan branch aktif benar, remote masih menunjuk ke origin yang tepat, dan tidak ada perubahan yang belum disimpan.

Tabel: Pesan Blocked, Penyebab, dan Arah Perbaikan

Masalah Penyebab Solusi
Blocked by branch protection Push langsung ke branch terkunci Push ke branch baru lalu buka Pull Request
Push protection: secret detected Commit membawa credential aktif Hapus secret, ganti placeholder, buat commit bersih
Permission denied / 403 Role kurang atau login kedaluwarsa Minta akses collaborator, perbaiki PAT atau SSH

Pilih satu baris yang kalimat errornya paling mirip dengan yang muncul di terminal. Itu menentukan langkah berikutnya.

Cara Memperbaiki Push Blocked Sesuai Penyebabnya

Untuk protected branch, alurnya:

  1. Buat branch baru dari branch aktif.
  2. Push branch baru ke GitHub.
  3. Buka Pull Request dari branch baru ke branch tujuan dan minta review bila diperlukan.
git checkout -b perbaiki-fitur
git push -u origin perbaiki-fitur

Untuk secret detected, jangan sekadar mengedit file lalu push lagi. Hapus nilai aslinya, ganti dengan placeholder seperti YOUR_API_KEY_HERE, commit ulang, lalu pastikan secret tidak tertinggal di history yang akan didorong. Jika secret sudah masuk beberapa commit, bersihkan history dulu karena menghapus file terakhir saja tidak cukup.

Untuk masalah izin dan autentikasi, cek undangan collaborator, pastikan akun yang login memang punya akses tulis, lalu perbarui credential HTTPS atau kunci SSH. Setelah itu sinkronkan dan dorong ulang:

git pull --rebase origin main
git push origin main

Force push bukan solusi umum. Ia menulis ulang history dan bisa menghapus pekerjaan orang lain.

FAQ

Apakah push blocked sama dengan rejected?

Tidak selalu. Blocked biasanya berasal dari aturan GitHub, sedangkan rejected sering berkaitan dengan history lokal yang tertinggal.

Bolehkah force push untuk membuka push blocked?

Jangan. Force push tidak membuka branch protection dan berisiko menghapus commit bersama.

Kapan harus minta bantuan owner repository?

Minta bantuan bila error menyebut permission, aturan organisasi, atau Pull Request membutuhkan persetujuan khusus.