非root用户访问Git仓库提示fatal错误的解决咨询

这种情况我碰到过好几次了，大概率是权限或者目录访问限制的问题，咱们一步步来排查解决：

1. 先确认用户是否真的在正确目录 #

有时候看起来cd到了目标目录，但可能因为目录名大小写、隐藏空格等问题导致实际路径不对。让非root用户执行：

pwd

确保输出是/home/gitproject，如果不是，重新正确切换目录再试。

2. 检查.git目录的权限（最常见原因） #

Git仓库的核心是隐藏的.git目录，root用户拥有最高权限可以无视权限限制，但普通用户需要有读取和进入该目录的权限。

查看权限详情 #

切换到root用户，执行：

ls -ld /home/gitproject/.git

正常情况下，输出的权限应该类似drwxr-xr-x（允许所属用户读写执行，同组和其他用户读执行），且所属用户/组是仓库的拥有者。如果权限是drwx------，那只有root和所属用户能访问，但如果所属用户也报错，可能是所属用户被意外修改了。

修复权限 #

• 先修复.git目录的所属用户和组（替换<仓库所属用户>和<所属组>为实际值，比如gituser:gitgroup）：

chown -R <仓库所属用户>:<所属组> /home/gitproject/.git

• 再设置合理的权限，确保所属用户有完全权限，同组用户能读和进入：

chmod -R 750 /home/gitproject/.git

如果需要其他用户也能访问该仓库，可以用755权限，但不建议开放给所有用户。

3. 排查SELinux限制 #

如果系统开启了SELinux，可能会阻止普通用户访问root创建的目录。

查看SELinux上下文 #

执行：

ls -Z /home/gitproject/.git

正常的用户目录文件上下文应该是类似unconfined_u:object_r:user_home_t:s0的格式，如果显示的是system_u:object_r:admin_home_t:s0（root目录的上下文），就会导致普通用户无法访问。

修复SELinux上下文 #

执行以下命令恢复默认的上下文：

restorecon -Rv /home/gitproject

4. 检查用户的Git环境变量 #

极少数情况下，用户的环境变量GIT_DIR被错误设置，导致Git找不到默认的.git目录。让非root用户执行：

echo $GIT_DIR

如果输出不是空值，说明该变量被设置了错误的路径，执行unset GIT_DIR临时取消，然后再试Git命令。如果问题反复出现，检查用户的~/.bashrc、~/.profile等配置文件，把设置GIT_DIR的行删掉。

验证修复 #

完成以上步骤后，切换到非root用户（包括仓库所属用户），进入/home/gitproject，执行git status，如果能正常显示仓库状态，就说明问题解决了。

内容的提问来源于stack exchange，提问作者Amir Torkashvand