Cara Mengatasi Git Pull Refusing To Merge Unrelated Histories dengan Aman

Error refusing to merge unrelated histories muncul karena Git lokal dan remote tidak punya commit awal yang sama. Perbaikan amannya: verifikasi remote dan branch dulu, lalu jalankan pull dengan flag khusus atau clone ulang kalau history memang tidak perlu digabung.

Penyebab Git Menolak Merge karena History Tidak Terkait

Git menolak menggabungkan dua riwayat yang berawal dari root commit berbeda. Ini proteksi agar commit tidak tercampur secara tidak sengaja.

  • Repo lokal dibuat dengan git init lalu disambung ke repo GitHub yang sudah berisi README atau commit awal.
  • Repo berasal dari template, hasil migrasi, atau clone dangkal sehingga garis history terputus.
  • Salah remote atau salah branch, misalnya origin menunjuk repo lain sehingga dua proyek berbeda dipaksa merge.

Tabel: Pola Error dan Langkah yang Tepat

Masalah Penyebab Solusi
Pull ditolak setelah init lokal Dua initial commit berbeda Gunakan flag allow-unrelated-histories setelah cek remote
Repo template atau hasil migrasi History lama tidak terbawa Gabungkan manual, atau mulai dari clone baru yang bersih
Remote atau branch keliru Origin menunjuk repo yang salah Perbaiki URL remote, jangan paksa merge
History sudah kacau dan sulit dilacak Merge sebelumnya gagal Pindahkan file ke clone baru, hindari force push langsung

Jangan langsung force push sebelum memeriksa history. Push paksa bisa menimpa commit milik orang lain di remote.

Cara Memperbaiki Pull yang Menolak Merge

  1. Simpan pekerjaan lokal, lalu cek status dan branch aktif.
  2. Periksa log, daftar remote, dan relasi branch lokal dengan remote.
  3. Kalau remote sudah benar dan dua history memang harus digabung, jalankan pull dengan izin khusus.
  4. Selesaikan konflik bila muncul, lalu stage dan commit hasilnya.
  5. Kalau remote salah atau history tidak perlu digabung, perbaiki remote atau clone ulang.
git status
git log --oneline --graph -10
git remote -v
git branch -vv
git pull origin main --allow-unrelated-histories

Bila terjadi konflik, buka file yang ditandai, pilih isi yang benar, lalu lanjutkan:

git add .
git commit

Hati-hati dengan rebase, reset –hard, dan force push. Ketiganya menulis ulang history dan bisa menghilangkan commit lokal maupun commit orang lain. Alternatif aman: clone ulang remote ke folder baru, lalu salin file pekerjaan dari repo lama secara manual.

FAQ

Apakah –allow-unrelated-histories aman dipakai?

Aman bila kedua repo memang harus digabung dan remote sudah diverifikasi, tetapi periksa konflik dengan teliti setelah merge.

Kapan harus clone ulang daripada memaksa merge?

Clone ulang lebih baik bila repo lokal hanya berisi percobaan awal dan remote adalah sumber history yang benar.

Kenapa error muncul lagi setelah merge berhasil?

Biasanya branch lokal masih menunjuk history lama atau remote berubah, jadi periksa kembali remote -v dan branch -vv.