Git で「fatal: refusing to merge unrelated histories」が解決できない

要約

fatal: refusing to merge unrelated histories は、共通の祖先コミットを持たない 2 つの履歴 を git merge または git pull で統合しようとしたときに、Git 2.9 以降が安全装置として拒否する状態。
統合が妥当なら --allow-unrelated-histories を明示的に付けて許可する。
そうでなければ履歴を繋がず別の取り込み方を選ぶ。

よくある原因

1. 空リポジトリ + 別履歴: GitHub 側で README 付きリポジトリを作り、手元の git init 済みプロジェクトを後から git pull した
2. リモートを後付け: ローカルで何度かコミットした後に git remote add し、初期コミットがリモートと噛み合わない
3. 2 リポジトリの統合: 別々に育てたリポジトリを 1 つにまとめようとしている
4. 履歴の作り直し: .git を削除して再 git init し、過去の履歴と分岐した

解決策

1. 意図的な統合なら明示フラグを付ける

git pull origin main --allow-unrelated-histories
# merge を直接呼ぶ場合
git merge other-branch --allow-unrelated-histories

Git 2.9 で既定が「拒否」に変わったため、統合が正しいと判断できるときだけ このフラグで上書きする。
詳細は git-merge 公式ドキュメント と git-pull 公式ドキュメント の --allow-unrelated-histories の項を参照。

2. リモートの初期コミットを取り込む

git remote add origin <url>
git fetch origin
git merge origin/main --allow-unrelated-histories

両方の履歴が残る。
同じファイル（README など）が衝突したら、通常のコンフリクト解消（編集 → git add → git commit）で片付ける。

3. ローカルがほぼ空なら clone し直す

git clone <url> project
# 手元の必要ファイルを project/ にコピーして
git add .
git commit -m "import local work"

履歴を無理に接続せず、リモートを正として作業を載せ替える方が後で履歴が読みやすい。

4. 別履歴として取り込む

2 つのプロジェクト履歴をどちらも保持したい場合は、merge ではなく subtree を使う。

git subtree add --prefix=vendor/lib <url> main

vendor/lib/ 配下に相手リポジトリを取り込み、自分の履歴とは分けて管理できる。
統合すべきでないものを --allow-unrelated-histories で繋ぐと、後からログ追跡が困難になる点に注意する。

実行例

実際に上記の手順を alpine/git 環境で動かすと、--allow-unrelated-histories なしの git merge は終了コード 128 で fatal: refusing to merge unrelated histories を返し、フラグを付けると ort ストラテジーで正常にマージが完了することを確認できる。

== versions ==
git version 2.54.0
== run ==
--- orphan ブランチで独立した（祖先を共有しない）履歴を作る ---
--- git merge other （refusing to merge unrelated histories を想定）---
fatal: refusing to merge unrelated histories
merge の終了コード: 128
--- 解決: --allow-unrelated-histories を付けて統合 ---
Merge made by the 'ort' strategy.
 b.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 b.txt
merge の終了コード: 0
--- 統合後のファイル一覧と git log --oneline ---
a.txt
b.txt
97758b0 Merge branch 'other'
00e3bd8 A: initial
b1c0250 B: initial (unrelated)

— 2026-06-19 時点の出力