Gitのunrelated historiesエラーを直す方法
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 します。
$ 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 ではまず取り込み方を指定するよう求めるエラーになります。
$ 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 を付けると、今回のエラーが出ます。
$ git pull --no-rebase origin main; echo "exit=$?"
From ../remote
* branch main -> FETCH_HEAD
fatal: refusing to merge unrelated histories
exit=128
エラーで止まったあとも、手元は何も変わっていません。
$ git status
On branch main
nothing to commit, working tree clean
$ ls
README.md
index.html
「関係のない履歴」とは
2つの履歴に、共通の祖先のコミットが1つもないという意味です。履歴の出発点(親のないコミット)だけを表示すると、main(手元)と origin/main(リモート)が、それぞれ別の出発点を持っていることが分かります。
$ 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 があるので、競合しました。
$ 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 と表示されています。
$ cat README.md
<<<<<<< HEAD
# ねこノート
猫のブログです。
=======
# neko-note
>>>>>>> a0e6fa71e8f3c94acbed2298e5d074cad8f38c6a
HEAD の側が手元の内容、>>>>>>> の側がリモートの内容です。ここでは見出しをリモートの # neko-note にし、説明の行は手元のものを残しました。直したら git add し、git commit でマージを終えます。--no-edit は、Git が用意したマージコミットのメッセージをそのまま使うためのオプションです。
$ 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つにつながりました。

もう一度 git merge-base を実行すると、今度は共通の祖先として a0e6fa7 が表示され、終了コードは 0 になりました。
$ git merge-base main origin/main; echo "exit=$?"
a0e6fa71e8f3c94acbed2298e5d074cad8f38c6a
exit=0
競合を直す前にやめたくなったときは、git status の表示にあるとおり、git merge --abort でマージの前に戻せます。
直したあとの push と pull
最初に断られた push は、今度は通りました。続けて git pull しても、エラーにはなりません。
$ 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 で競合しました。
$ 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 の手順に進んでいます。





