...
Eroare Git · Push, remote și GitHub

fatal: refusing to merge unrelated histories

Pe scurt

Cele două branch-uri nu au niciun commit comun, de obicei pentru că ai creat repository-ul pe GitHub cu un README și separat ai făcut git init local. Dacă chiar vrei să le unești, rulează git pull origin main --allow-unrelated-histories, rezolvă conflictele, apoi git push.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un merge obișnuit pornește de la un strămoș comun al celor două branch-uri. Când istoriile nu au niciun commit comun, Git (de la versiunea 2.9) refuză merge-ul, pentru că de cele mai multe ori e o greșeală: ai legat proiectul de alt repository decât credeai.

Cazul tipic pentru începători: creezi repository-ul pe GitHub bifând „Add a README”, deci pe server există deja un commit; local faci git init, câteva commit-uri și git remote add origin. Primul git push e respins (fetch first), iar git pull dă acest mesaj, pentru că cele două istorii au pornit separat. Dacă ești sigur că e repository-ul corect, opțiunea --allow-unrelated-histories permite merge-ul. Dacă pe server e doar un README generat, poți să-l unești sau să-l înlocuiești.

De ce apare: cauzele frecvente

1Repository creat pe GitHub cu README, plus git init local

Greșit
BASH
git remote add origin https://github.com/elev/retete.git
git pull origin main
Corect
BASH
git pull origin main --allow-unrelated-histories
git push -u origin main

Opțiunea permite merge-ul a două istorii fără strămoș comun. Rezultatul are un commit de merge cu ambele.

2Ai legat proiectul de un repository greșit

Greșit
BASH
git remote add origin https://github.com/elev/alt-proiect.git
git pull origin main
Corect
BASH
git remote set-url origin https://github.com/elev/retete.git
git pull origin main

Aici refuzul te-a protejat: corectezi adresa, nu forțezi merge-ul.

3Ai refăcut .git (rm -rf .git, apoi git init)

Greșit
BASH
rm -rf .git
git init
git add .
git commit -m "Din nou"
git pull
Corect
BASH
git clone https://github.com/elev/retete.git retete-curat
# copiază modificările în clona nouă

Un git init nou începe o istorie nouă, fără legătură cu cea de pe server. O clonă proaspătă păstrează istoria.

Repară tu

Repară eroarea, direct în pagină

Ai creat repository-ul retete pe GitHub cu un README.md, iar local ai făcut git init și un commit cu index.html. Push-ul e respins, iar în Git-ul real git pull origin main dă fatal: refusing to merge unrelated histories. Unește cele două istorii (păstrând ambele fișiere) cu opțiunea potrivită și urcă main, fără push forțat.

Indiciu

git pull are o opțiune care permite unirea istoriilor fără strămoș comun.

Alte forme ale mesajului

  • fatal: refusing to merge unrelated histories Error redoing merge 3f2a1b4

Cum o eviți pe viitor

  • Când ai deja proiectul local, creează repository-ul pe GitHub gol (fără README, licență sau .gitignore).
  • Când proiectul există deja pe GitHub, pornește cu git clone, nu cu git init.
  • Nu șterge folderul .git ca să „repari” ceva: pierzi legătura cu istoria de pe server.

Întrebări frecvente

E periculos --allow-unrelated-histories?

Nu strică nimic, dar poate uni două proiecte care n-au legătură. Folosește-l doar când știi că cele două istorii aparțin aceluiași proiect.

De ce nu dă eroarea la git push?

Push-ul nu face merge: e respins cu fetch first, pentru că serverul are commit-uri pe care nu le ai. Refuzul apare la pasul următor, git pull.

Erori înrudite

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Git de la zero, cu exerciții la fiecare lecție

Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.