Jenkins推送Git代码报错：cannot lock existing info/refs问题求助

我之前在Jenkins流水线里推送Git仓库时也遇到过一模一样的问题，结合你的代码和场景，给你几个实用的排查和修复方案：

1. 清理Git本地残留锁文件 #

这个报错最常见的原因是之前的推送操作异常中断，留下了锁文件阻塞新的推送。你可以在流水线里先添加清理锁文件的步骤：

# 删除分支、索引及info/refs相关的锁文件
rm -f ${projectDirectory}/.git/refs/heads/${branch}.lock
rm -f ${projectDirectory}/.git/refs/remotes/origin/${branch}.lock
rm -f ${projectDirectory}/.git/index.lock
rm -f ${projectDirectory}/.git/info/refs.lock

2. 修正Jenkins工作空间权限与Git配置 #

Jenkins运行的系统用户（通常是jenkins）需要对项目目录有完整的读写权限，同时不要用全局Git配置（会影响所有Jenkins任务），改用仓库级配置更安全：

# 递归设置工作空间权限，确保Jenkins用户能操作.git目录
chown -R jenkins:jenkins ${projectDirectory}
chmod -R 755 ${projectDirectory}/.git

# 设置当前仓库专属的用户信息，替代--global参数
git config user.name "jenkinsSCM"
git config user.email "xxx.xxxx.xxx@xxx.xxx"

3. 优化Git HTTP推送配置 #

HTTP推送大文件或网络不稳定时容易触发锁问题，你可以调整Git的HTTP缓冲区大小，提升推送稳定性：

git config http.postBuffer 524288000

另外要确保Jenkins已配置正确的仓库凭证（用户名密码/SSH密钥），避免因认证失败导致推送中断并残留锁文件。

4. 确保工作空间干净且分支状态同步 #

推送前先拉取远程最新代码，避免本地分支与远程不一致引发冲突或锁问题：

# 切换分支后拉取远程最新代码
git checkout ${branch}
git pull origin ${branch}

# 检查本地状态，确保没有未提交/冲突的文件
git status

5. 调整后的完整流水线函数示例 #

结合以上修复点，优化你的函数代码：

def commitBuildNumberChanges(currentProjectVersion, newVersion, projectDirectory) {
    echo "Preparing updated files for commit..."
    def POM = "pom.xml"
    def BUILD_NUMBER_CHANGES_COMMIT_MESSAGE = "Update build number from ${currentProjectVersion} to ${newVersion}"
    def branch = env.BRANCH_NAME

    sh """
        cd ${projectDirectory}
        # 清理可能存在的锁文件
        rm -f .git/refs/heads/${branch}.lock .git/refs/remotes/origin/${branch}.lock .git/index.lock .git/info/refs.lock
        # 切换分支并拉取远程最新代码
        git checkout ${branch}
        git pull origin ${branch}
        # 设置仓库级用户信息
        git config user.name "jenkinsSCM"
        git config user.email "xxx.xxxx.xxx@xxx.xxx"
        # 调整HTTP推送缓冲区
        git config http.postBuffer 524288000
        # 修改pom.xml版本（假设你有这一步逻辑）
        mvn versions:set -DnewVersion=${newVersion}
        # 提交并推送
        git add ${POM}
        git commit -m "${BUILD_NUMBER_CHANGES_COMMIT_MESSAGE}"
        git push origin ${branch}
    """
}

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