Gitで「fatal: detected dubious ownership in repository」エラーの対処法【Mac環境】

最近のGitのセキュリティアップデート（特にv2.35以降）によって、一部の開発者にとって意外なトラブルが発生しています。その代表格が、Git実行時に表示される以下のエラーです。

fatal: detected dubious ownership in repository at '/path/to/repo'

これは、リポジトリが信頼されていないとGitが判断したことに起因するもので、セキュリティ観点からの正当な制限です。しかし、普段からローカルで作業しているディレクトリで突然このようなエラーが出ると、開発が止まってしまう恐れがあります。
本記事では、このエラーの発生原因から根本的な対処法までを、Mac環境を前提に解説していきます。

目次

1. エラーの発生原因と背景

このエラーは、Gitが「このリポジトリは所有者が現在のユーザーと一致していない」または「信頼できない場所に存在している」と判断した場合に発生します。Git v2.35以降から導入された、safe.directory の概念が背景にあります。

具体的には以下のようなケースで発生します。

  • sudo 権限でGit操作をしたことがある
  • ホームディレクトリ外にリポジトリを配置している（例：/tmp, /mnt, /Volumes）
  • 所有者が異なるユーザーに設定されている（チーム共有など）
  • GitHub Codespaces や CI/CD の一時ディレクトリ上で操作している

これにより、Gitは信頼できないディレクトリの操作を制限し、不正なリポジトリへのアクセスや実行を防止しています。

確認コマンド

以下のようにして、所有者やパーミッションが意図と異なっていないかを確認できます。

ls -la /path/to/repo

これで、自分のユーザーIDと所有者が異なることが分かれば、エラー原因の一端となっている可能性があります。

2. 一時的な対処法：safe.directoryの追加

最も簡単で直接的な方法は、問題のリポジトリをGitにとって「安全」なディレクトリとして明示することです。

次のようにGitのグローバル設定に追記します。

git config --global --add safe.directory /path/to/repo

複数のリポジトリで同様のエラーが出る場合は、それぞれのパスを safe.directory に追加する必要があります。

また、全ディレクトリを信頼するという荒技もありますが、これはセキュリティ上推奨されません。

git config --global --add safe.directory '*'

この設定はCIや一時的な検証には有用ですが、常用することは控えましょう。

注意点

  • ワイルドカード（*）を使うと全ディレクトリが信頼されるため、安全性が著しく低下します
  • チーム共有の場合は、他の開発者の環境でも個別に設定が必要になることがあります

3. 所有者の修正による根本対応

Mac環境では、ファイルやディレクトリの所有者が異なることがよくあります。特に sudo で git clone などを実行した場合、root が所有者になることが原因です。

この場合、chown コマンドを使って正しい所有者に修正します。

sudo chown -R $(whoami) /path/to/repo

このコマンドは、リポジトリ全体の所有権を現在のユーザーに再帰的に設定し直すものです。

コマンド解説

  • sudo: 権限昇格（管理者権限）
  • chown -R: 所有者変更（-R は再帰的）
  • $(whoami): 現在のログインユーザー名を取得

これにより、Gitは所有者の不一致による「疑わしいディレクトリ」として認識しなくなります。

4. .gitconfigのローカル設定を見直す

意外と見落としがちなのが、プロジェクトごとの .git/config ファイルです。ここで safe.directory の設定がされていない、あるいは誤って削除されてしまっている場合にも、同様のエラーが発生します。

リポジトリ直下の .git/config を確認し、以下のような設定が含まれているかを確認します。

[core]
    repositoryformatversion = 0
    filemode = true
    bare = false
    logallrefupdates = true
[safe]
    directory = /path/to/repo

この設定が欠けている場合、明示的に追加することで問題が解消されることがあります。

編集例

vim .git/config

あるいは、スクリプトで自動化することも可能です。

5. CI環境やマウントディレクトリでの考慮事項

Mac環境に限らず、DockerコンテナやCI環境（GitHub Actions, GitLab CIなど）では、ホームディレクトリ以外にチェックアウトする場合があり、Gitが「信頼できない」と判断するリスクが高くなります。

このようなケースでは、CIスクリプト中で明示的に safe.directory を指定するのが確実です。

git config --global --add safe.directory "$PWD"

また、Docker環境ではマウント時のユーザーID・パーミッションも重要です。ホストマシンとの不一致があると、Gitが警告を出す可能性があります。

対応策の例

  • コンテナ起動時に --user $(id -u):$(id -g) を付与する
  • Dockerfile内で chown を設定する
RUN chown -R myuser:mygroup /workspace/repo

CIや開発用コンテナ環境では、こうした対応がより確実かつ安全です。

6. Gitのバージョンとセキュリティポリシーの変遷

このエラーは、2022年以降のGitに導入されたセキュリティ機構によって生じた新たな制約です。具体的には、Git v2.35.1 以降で導入された safe.directory によって、安全でないパスや所有者不一致のディレクトリを拒否する仕様に変わりました。

git --version

このコマンドで、手元のGitバージョンを確認しましょう。

もし古いGitを使っていても、今後のアップデートで同様のエラーが発生する可能性があります。特にHomebrewでGitを管理しているMacユーザーは、常に brew upgrade git によって最新の安定版を導入しておくと良いでしょう。

また、.gitconfig の設定を見直しておくことで、セキュリティ強化と開発の利便性を両立できます。

まとめ

「fatal: detected dubious ownership in repository」というGitエラーは、セキュリティ強化の一環として導入された正当なチェック機構に起因します。しかし、開発現場にとっては突然のブロッカーにもなりうるため、正しく原因を理解し、適切な対処を行うことが重要です。

対応方法としては以下のようなものがありました。

  • git config --global --add safe.directory による明示的な許可
  • chown による所有者の修正
  • .git/config の設定見直し
  • CIやDocker環境でのユーザー指定とsafe設定
  • Gitのバージョン管理と最新のセキュリティ仕様への理解

とくにMac環境では権限の扱いが複雑になりやすいため、ユーザー単位の設定・所有権・マウントの構造を意識した運用が求められます。

参考

タイトルとURLをコピーしました