できない.dev

Git「fatal: refusing to merge unrelated histories」の原因と直し方

fatal: refusing to merge unrelated histories は、共通の祖先が無い履歴を統合すると出る。
意図した統合なら --allow-unrelated-histories を付ければ通る。

公開: 更新:

症状できない · exit 128
git merge other
fatal: refusing to merge unrelated histories
解決後できた · exit 0
git merge other --allow-unrelated-histories --no-edit
Merge made by the 'ort' strategy.
 b.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 b.txt

2026-08-02 に alpine/git で実際に打って取った出力。検証環境の詳細

要約

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

実行例

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

$ git merge other
fatal: refusing to merge unrelated histories
$ echo $?
128
$ git merge other --allow-unrelated-histories --no-edit
Merge made by the 'ort' strategy.
 b.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 b.txt
$ echo $?
0
$ ls
a.txt
b.txt
$ git log --oneline
6df4dff Merge branch 'other'
6485cb8 A: initial
8bec050 B: initial (unrelated)

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
alpine/git

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

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 で繋ぐと、後からログを追いにくくなる。

よくある原因

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