GitLab CI通过SSH部署时git pull命令无法执行的问题排查

我来帮你梳理下这两个问题——先从优化.gitlab-ci.yml的写法说起，再排查git pull失败的核心原因：

针对GitLab Runner SSH执行器的场景，下面是一套更清晰、可维护的Laravel部署配置，融入了CI/CD最佳实践：

# 全局变量：把可变配置抽离，方便后续修改
variables:
  APP_ENV: production
  DEPLOY_SERVER: 你的服务器IP/域名
  DEPLOY_USER: SSH登录用户名
  DEPLOY_PROJECT_PATH: /var/www/laravel-app
  GIT_STRATEGY: none  # 无需Runner本地克隆代码，直接复用服务器上的.git仓库

# 阶段拆分：后续可轻松扩展测试、构建等阶段
stages:
  - deploy

# 部署任务核心逻辑
deploy_to_production:
  stage: deploy
  tags:
    - ssh-runner  # 指定你的SSH执行器标签
  before_script:
    - echo "🔍 初始化SSH连接环境..."
    # 提前扫描服务器SSH指纹，避免首次连接的确认弹窗中断CI
    - ssh-keyscan -H $DEPLOY_SERVER >> ~/.ssh/known_hosts
  script:
    - echo "🚀 开始部署Laravel应用..."
    # 用&&串联命令，确保前一步成功才执行后续操作，避免半失败状态
    - ssh $DEPLOY_USER@$DEPLOY_SERVER "cd $DEPLOY_PROJECT_PATH &&
        git pull origin develop &&
        composer install --no-dev --optimize-autoloader --no-interaction &&
        php artisan migrate --force &&
        php artisan config:cache &&
        php artisan route:cache &&
        php artisan view:cache &&
        chmod -R 775 storage bootstrap/cache &&
        echo '✅ 部署完成！'"
  only:
    - develop  # 仅在develop分支推送时触发部署
  allow_failure: false
  after_script:
    - echo "📋 部署流程已结束"

优化点说明： #

• 变量复用：把服务器地址、部署路径等抽成全局变量，修改时无需改动核心脚本
• 资源节省：设置GIT_STRATEGY: none，避免Runner重复克隆代码，利用服务器上已有的.git仓库
• 错误阻断：用&&串联命令，某一步失败则整个部署终止，防止出现半部署状态
• Laravel专属优化：添加生产环境必备的缓存、权限修复命令，符合Laravel部署规范
• 日志可读性：加入emoji和提示信息，方便快速定位CI日志中的关键节点

git log能正常运行说明本地.git仓库是健康的，但git pull需要和远程仓库通信，大概率是以下几个原因，按优先级排查：

1. 远程仓库认证失败 #

git log只读取本地数据，而git pull需要拉取远程代码，首先检查服务器上的Git是否有权限访问你的GitLab实例：

• 如果用SSH协议：在服务器上执行ssh -T git@你的GitLab域名/IP，验证连通性。如果报错Permission denied，说明服务器的SSH私钥未添加到GitLab的SSH密钥列表中
• 如果用HTTPS协议：检查Git是否保存了凭证（CI环境下可以用git config credential.helper store持久化凭证），或者手动执行git pull看是否需要输入账号密码

2. 本地分支未与远程分支建立追踪关系 #

可能服务器上的develop分支没有绑定远程的origin/develop，导致git pull不知道拉取哪个分支：

• 在服务器上执行git branch -vv查看分支追踪状态，如果develop后没有显示origin/develop，执行以下命令绑定：

  git branch --set-upstream-to=origin/develop develop
  

3. 工作目录状态异常 #

比如服务器上的项目目录有未提交的修改、冲突，导致git pull无法执行：

• 执行git status查看状态，如果有未提交文件，先暂存：

  git stash
  

  拉取完成后再恢复：

  git stash pop
  

4. 权限问题 #

检查服务器上.git文件夹和项目目录的权限，确保SSH执行器的用户拥有读写权限：

• 执行ls -la $DEPLOY_PROJECT_PATH/.git查看权限，所有者/组应与SSH用户一致，不一致则执行：

  sudo chown -R 你的SSH用户名:用户组 $DEPLOY_PROJECT_PATH/.git
  

快速排查技巧 #

建议先在服务器上手动执行git pull origin develop，查看完整的报错信息——CI日志可能会截断部分错误，手动执行能直接定位问题根源。

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