使用Capistrano设置Git URL时遭遇权限错误的排查与解决

核心问题分析 #

报错error: could not lock config file config: Permission denied是因为用户bob在目标机器（1.2.3.4）上执行git remote set-url时，没有权限写入或锁定Git仓库的配置文件。

具体问题解答 #

1. 报错中的config文件位置
   这里的config文件是目标部署机器上对应Git仓库根目录下的.git/config。Git修改仓库本地配置时，会尝试锁定该文件（生成.git/config.lock临时文件），如果没有写入权限就会触发报错。

2. 是否需要修改文件权限？具体是哪个文件？
   需要修改权限，核心是确保bob对仓库的.git目录及其内部文件拥有写入权限：

   • 先登录到1.2.3.4机器，切换到bob身份，找到部署用的仓库目录，执行以下命令检查权限：

     ls -ld .git          # 查看.git目录的权限和所属用户/组
     ls -l .git/config    # 查看config文件的权限和所属
     

   • 如果.git目录或config文件属于你的用户（而非bob），可以通过以下方式修复：
     • 方式一：将.git目录的所有权转给bob：

       sudo chown -R bob:bob /path/to/repo/.git  # 替换成实际仓库路径
       

     • 方式二：如果bob和你的用户同属一个组，给组添加写入权限：

       sudo chgrp -R your-group /path/to/repo/.git  # 替换成共同组名
       sudo chmod -R g+w /path/to/repo/.git
       

3. bob是否需要更多权限？
   不需要额外的系统级权限，只需要拥有目标仓库.git目录的写入权限即可。这是修改Git本地配置的必要条件。

额外排查点 #

如果修改权限后仍报错，检查部署脚本是否在正确的仓库目录下执行git命令——如果脚本错误地在非仓库目录执行git remote set-url，Git会尝试创建当前目录下的config文件，同样会触发权限拒绝。

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