Gitで「fatal: refusing to merge unrelated histories」エラーが出たときの原因と解決方法

Gitを使った開発では、さまざまな場面でエラーに遭遇することがあります。中でも「fatal: refusing to merge unrelated histories」というエラーは、原因が分かりにくく、解決方法にも戸惑いやすいものの一つです。この記事では、このエラーの発生原因と具体的な対処法をわかりやすく解説します。

エラーが発生する原因

このエラーは、Gitリポジトリからクローンしたプロジェクトのローカル環境において、.gitディレクトリが何らかの理由で削除されたり、破損したりした場合に発生します。

.gitディレクトリは、リモートリポジトリとの変更履歴をバージョン管理システムが追跡するために不可欠な存在です。ローカルリポジトリのルートディレクトリでls -aコマンドを実行すると、隠しディレクトリとして.gitが一覧に表示されることを確認できます。

この.gitディレクトリが失われると、Gitはローカル側のコミット履歴を認識できなくなります。その結果、リモートリポジトリに対してpushやpullを行った際に、ローカルとリモートが「無関係な履歴（unrelated histories）」を持つ別々のプロジェクトとみなされ、マージが拒否されてしまうのです。

解決方法

この問題に対するGit公式の解決策は、pullコマンドに--allow-unrelated-historiesオプションを付けて実行することです。

git pull origin master --allow-unrelated-histories

このオプションを指定すると、Gitの履歴が一致しない2つのプロジェクトでも強制的にマージできるようになります。詳細については、Gitの公式ドキュメントも参照するとよいでしょう。

上記のコマンドでpullを実行した後は、通常どおりpushが可能になっているはずです。もしブランチ名が異なる場合は、masterの部分を実際のブランチ名（例：main）に置き換えて実行してください。