Gitのunrelated historiesエラーを直す方法

​​Git​コマンドライン,トラブルシュート

git pull が fatal: refusing to merge unrelated histories で止まったときは、--allow-unrelated-histories を付けてもう一度 git pull すると、2つの履歴をマージでつなげます。手元で git init して作業していたリポジトリを、ホスティングサービスで README 付きで作った新しいリポジトリにつないで push しようとしたときに出るエラーです。以下では、エラーを実際に起こしてから直すまでを、検証環境で打ったコマンドの出力そのままで載せます。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、出力が毎回同じになるよう、コミットの日時を環境変数で決めました。リモートは同じ検証環境の中に作ったリポジトリで、README.md だけの最初のコミットを入れて、README 付きで作ったリポジトリの代わりにしました。手元からは相対パス ../remote.git で指しているため、出力の From の行やマージコミットのメッセージには ../remote、To の行には ../remote.git と表示されています。GitHub などのホスティングサービスとの通信、Windows・macOS、リベースでの競合の解決は試していません。

エラーが出るまで

リモートには、README.md だけのコミット Initial commit があります。手元では、それとは関係なく git init したリポジトリで index.html と README.md を作り、最初のコミット を作りました。そのあと git remote add origin ../remote.git でリモートを登録し、push します。

console
$ git push -u origin main; echo "exit=$?"
To ../remote.git
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to '../remote.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
exit=1

リモートに手元にないコミットがあるので、push は断られました。pull.rebase などで取り込み方を設定していない場合、hint のとおり git pull origin main を実行すると、Git 2.43.0 ではまず取り込み方を指定するよう求めるエラーになります。

console
$ git pull origin main; echo "exit=$?"
From ../remote
 * branch            main       -> FETCH_HEAD
 * [new branch]      main       -> origin/main
hint: You have divergent branches and need to specify how to reconcile them.
(中略)
fatal: Need to specify how to reconcile divergent branches.
exit=128

途中の hint の行は省きました。取り込み方をマージにする --no-rebase を付けると、今回のエラーが出ます。

console
$ git pull --no-rebase origin main; echo "exit=$?"
From ../remote
 * branch            main       -> FETCH_HEAD
fatal: refusing to merge unrelated histories
exit=128

エラーで止まったあとも、手元は何も変わっていません。

console
$ git status
On branch main
nothing to commit, working tree clean

$ ls
README.md
index.html

「関係のない履歴」とは

2つの履歴に、共通の祖先のコミットが1つもないという意味です。履歴の出発点(親のないコミット)だけを表示すると、main(手元)と origin/main(リモート)が、それぞれ別の出発点を持っていることが分かります。

console
$ git log --all --max-parents=0 --oneline
1a3f57c 最初のコミット
a0e6fa7 Initial commit

$ git merge-base main origin/main; echo "exit=$?"
exit=1

git merge-base は、2つのコミットの共通の祖先を探すコマンドです。ここでは何も表示せず、終了コード 1 で終わりました。共通の祖先が見つからなかったということです。なお、git log --graph --oneline --all では * が縦に2つ並ぶだけで、出発点が2つあることは分からないので、上の --max-parents=0 で確かめるほうが確実です。

Git 2.9.0 のリリースノートによると、以前の git merge は共通の祖先がない2つのブランチも、そのままマージしていました。そのため、既存のプロジェクトとは別に一から作られた履歴を、気づかないまま取り込んでしまうことがありました。2.9.0 からは、これを既定では断るようになっています。

–allow-unrelated-histories でつなぐ

手元とリモートが、確かに同じプロジェクトのつもりで作ったものなら、--allow-unrelated-histories を付けて取り込みます。今回は両方に README.md があるので、競合しました。

console
$ git pull --no-rebase --allow-unrelated-histories origin main; echo "exit=$?"
From ../remote
 * branch            main       -> FETCH_HEAD
Auto-merging README.md
CONFLICT (add/add): Merge conflict in README.md
Automatic merge failed; fix conflicts and then commit the result.
exit=1

$ git status
On branch main
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both added:      README.md

no changes added to commit (use "git add" and/or "git commit -a")

今回は両方の履歴が README.md を別々に新しく作っていて、中身が違うため、CONFLICT (add/add) として競合しました。git status でも both added と表示されています。

console
$ cat README.md
<<<<<<< HEAD
# ねこノート

猫のブログです。
=======
# neko-note
>>>>>>> a0e6fa71e8f3c94acbed2298e5d074cad8f38c6a

HEAD の側が手元の内容、>>>>>>> の側がリモートの内容です。ここでは見出しをリモートの # neko-note にし、説明の行は手元のものを残しました。直したら git add し、git commit でマージを終えます。--no-edit は、Git が用意したマージコミットのメッセージをそのまま使うためのオプションです。

console
$ printf '# neko-note\n\n猫のブログです。\n' > README.md

$ git add README.md

$ git commit -q --no-edit

$ git log --graph --oneline --all
*   d159c45 Merge branch 'main' of ../remote
|\  
| * a0e6fa7 Initial commit
* 1a3f57c 最初のコミット

マージコミット d159c45 が、手元の 1a3f57c とリモートの a0e6fa7 の両方を親に持ち、2つの履歴が1つにつながりました。

上は取り込む前で、リモートの a0e6fa7 と手元の 1a3f57c が線でつながっていない。下は --allow-unrelated-histories で取り込んだ後で、マージコミット d159c45 が2つを親に持っている
–allow-unrelated-histories で取り込む前と後の履歴

もう一度 git merge-base を実行すると、今度は共通の祖先として a0e6fa7 が表示され、終了コードは 0 になりました。

console
$ git merge-base main origin/main; echo "exit=$?"
a0e6fa71e8f3c94acbed2298e5d074cad8f38c6a
exit=0

競合を直す前にやめたくなったときは、git status の表示にあるとおり、git merge --abort でマージの前に戻せます。

直したあとの push と pull

最初に断られた push は、今度は通りました。続けて git pull しても、エラーにはなりません。

console
$ git push -u origin main; echo "exit=$?"
To ../remote.git
   a0e6fa7..d159c45  main -> main
branch 'main' set up to track 'origin/main'.
exit=0

$ git pull; echo "exit=$?"
Already up to date.
exit=0

$ git pull --no-rebase origin main; echo "exit=$?"
From ../remote
 * branch            main       -> FETCH_HEAD
Already up to date.
exit=0

--allow-unrelated-histories は、一度マージして履歴がつながれば、その後の git pull には要りません。git merge の公式リファレンスにある –allow-unrelated-histories の説明では、このオプションは別々に始まった2つのプロジェクトの履歴をマージする、ごくまれな場面のためのものなので、既定で有効にする設定は用意しておらず、今後も足さないと書かれています。毎回付けるのではなく、つなぐときに一度だけ使うオプションです。

注意

リモートの URL を間違えて、まったく別のリポジトリにつないだときにも、同じエラーが出ます。--allow-unrelated-histories を付ける前に、git remote -v で指しているリモートを確かめてください。付けて取り込むと、相手の履歴が手元に丸ごと入り、そのまま push すればリモートにも入ります。

git pull –rebase ではこのエラーは出ない

--allow-unrelated-histories は、マージのためのオプションです。git pull の公式リファレンスにある同じオプションの説明にも、マージするときにだけ意味がある、と書かれています。

エラーで止まった状態から git pull --rebase origin main を試したところ、refusing to merge unrelated histories は出ず、手元のコミットをリモートのコミットの後ろに積み直そうとして、同じ README.md で競合しました。

console
$ git pull --rebase origin main; echo "exit=$?"
From ../remote
 * branch            main       -> FETCH_HEAD
Auto-merging README.md
CONFLICT (add/add): Merge conflict in README.md
error: could not apply 1a3f57c... 最初のコミット
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".
hint: You can instead skip this commit: run "git rebase --skip".
hint: To abort and get back to the state before "git rebase", run "git rebase --abort".
Could not apply 1a3f57c... 最初のコミット
exit=1

実際の出力では、Auto-merging の行の前に、進み具合を示す Rebasing (1/1) があります。そのあとに行の先頭に戻る制御文字が続き、端末では上書きされて消えるので、ここでは省きました。また、検証ではこの制御文字を見えるようにするため、出力を sed に通して実行しています。検証では git rebase --abort で取り込む前の状態に戻し、上の --allow-unrelated-histories の手順に進んでいます。

​Posted by 86