GitLab CI多Runner提交仓库时，如何修复Git变基目录报错？

DevOps 小满

2026-7-16

GitLab CI多Runner提交时Git rebase-merge目录报错修复方案

报错原因

多Runner并行操作同一分支时，前一次git pull --rebase操作因冲突未处理、进程意外终止等异常情况中断，导致.git/rebase-merge目录残留，后续执行rebase操作时触发该错误。

即时临时修复

在执行git pull --rebase前添加检查并清理残留目录的逻辑，确保rebase操作能正常启动：

# 检查并清理残留的rebase-merge目录
if [ -d ".git/rebase-merge" ]; then
  rm -fr ".git/rebase-merge"
fi

git add ${FILE}
git commit -m "$COMMIT_MESSAGE" -m "$COMMIT_DESCRIPTION" || true
git pull --rebase origin ${CI_COMMIT_REF_NAME}
git push --set-upstream origin ${CI_COMMIT_REF_NAME}

长期稳定解决方案

1. 限制分支并行执行

通过GitLab CI的resource_group机制，确保同一分支同时只有一个Runner任务在执行，从根源避免并行操作冲突：

# 在你的CI任务中添加resource_group配置
your_commit_job:
  resource_group: ${CI_COMMIT_REF_NAME}-branch-lock
  script:
    - git add ${FILE}
    - git commit -m "$COMMIT_MESSAGE" -m "$COMMIT_DESCRIPTION" || true
    - git pull --rebase origin ${CI_COMMIT_REF_NAME}
    - git push --set-upstream origin ${CI_COMMIT_REF_NAME}

2. 优化提交流程逻辑

调整脚本顺序，先拉取最新代码再提交，减少冲突概率；同时处理空提交和rebase失败场景：

# 先拉取最新代码，确保本地基于最新版本操作
git pull --rebase origin ${CI_COMMIT_REF_NAME}

# 仅当有文件变更时执行提交，避免空提交
git add ${FILE}
git diff --cached --quiet || git commit -m "$COMMIT_MESSAGE" -m "$COMMIT_DESCRIPTION"

# 再次拉取（防止拉取后到提交前有新变更），失败则清理残留目录
git pull --rebase origin ${CI_COMMIT_REF_NAME} || {
  rm -fr ".git/rebase-merge"
  exit 1
}

git push --set-upstream origin ${CI_COMMIT_REF_NAME}