Ansible执行Git克隆报fatal错误 手动SSH克隆正常如何排查

问题根因 #

这个报错和SSH密钥、Agent转发配置无关——你之前调整的forwardAgent、key_file参数都是解决远程仓库认证失败问题的，但当前报错是Ansible执行到本地仓库校验步骤就失败了，根本没发起和GitHub的远程连接。

Ansiblegit模块的执行逻辑是：如果dest指定的目标路径已存在，会默认进入该目录执行Git操作，不会重新走全量克隆流程。报错中执行的命令是git ls-remote origin，说明模块已经判定目标目录是一个已存在的Git仓库，尝试读取本地配置的origin远程仓库地址，但此时目录下的Git元数据（.git文件夹）已经损坏：

• 大概率是历史部署流程意外中断，导致.git/config文件丢失、没有写入origin远程配置
• 小概率是目录权限混乱，执行Git操作的用户无权限读取.git目录下的配置文件

你手动SSH到服务器执行git clone能成功，是因为手动操作时你选择了空目录、或者删除了旧的损坏目录，走的是全新克隆流程，自然不会触发这个问题。

修复方案 #

• 优先清理损坏的旧目录（最快解决）
  登录目标服务器，直接删除损坏的项目目录：

  # 替换为你实际的project_root路径，Trellis默认路径一般为/srv/www/<你的站点名>/shared/source
  rm -rf /path/to/your/project_root/shared/source
  

  删除后重新执行Ansible部署任务即可，模块会自动重新完成全量克隆，不会再触发该错误。

• 修正配置中的权限问题
  你当前配置里become: yes已开启，但become_user行被注释，会默认用root用户执行Git操作，和你手动测试时用的登录用户环境不一致，很容易后续出现权限问题：

  • 放开become_user: "{{ project.user.name | default(ansible_web_user) }}"的注释，用站点运行用户（Trellis默认为web用户）执行克隆操作，不要用root用户
  • 你注释掉的key_file配置写法错误：该参数需要传入SSH私钥路径，你写的/root/.ssh/id_rsa.pub是公钥文件，私钥路径不带.pub后缀，如果需要手动指定密钥请修正路径。

• 不删目录的临时修复方案
  如果不想删除已有目录，可以先切换到和Ansible执行一致的用户（比如root或者web用户），进入目标source目录执行校验：

  # 进入目标目录
  cd /path/to/your/project_root/shared/source
  # 查看现有远程配置
  git remote -v
  

  • 如果执行后没有任何origin相关的输出，直接手动添加远程地址：git remote add origin git@github.com:<你的仓库地址>.git，之后重新跑部署即可
  • 如果执行git remote -v直接报错提示"not a git repository"，说明.git目录完全损坏，直接删除目录重跑是最高效的方案，不用尝试修复元数据。

内容的提问来源于stack exchange，提问作者Kormi Web Solutions