通过GitHub Actions触发Jenkins构建失败，遇权限拒绝错误

问题描述 #

通过GitHub Actions的trigger-jenkins-build.yml触发Jenkins构建时，Jenkins任务因权限问题失败，但GitHub Actions流程显示执行成功。Jenkins核心报错如下：

java.nio.file.AccessDeniedException: /home/subbaramaiah_ch/Jenkins/workspace/subbu_project/.git/config.lock

排查与解决步骤 #

1. 深度校验Jenkins代理节点的工作区权限 #

• 确认Jenkins代理进程的运行用户（如jenkins或自定义用户）对/home/subbaramaiah_ch/Jenkins/workspace/subbu_project/.git/目录及父目录拥有完整的读写执行权限，检查权限链是否中断。
• 手动删除工作区中残留的.git/config.lock文件（若存在），重新触发构建，排查是否为前次构建遗留的锁文件导致冲突。
• 在代理节点上，用Jenkins运行用户执行命令touch /home/subbaramaiah_ch/Jenkins/workspace/subbu_project/.git/test.lock，直接验证该用户是否能创建锁文件，定位权限问题根源。

2. 调整Jenkins Git插件的钩子配置 #

报错栈显示问题出在Git插件禁用钩子时创建锁文件的环节，可尝试：

• 在Jenkins任务的Git配置中，找到Git Hooks相关设置，勾选「Disable git hooks」选项，直接禁用插件的钩子自动配置功能。
• 将Jenkins Git插件和Git Client插件升级至最新稳定版本，排查是否为插件版本兼容性导致的锁文件权限处理异常。

3. 同步GitHub Actions与Jenkins构建状态 #

GitHub Actions显示成功仅代表完成了「触发Jenkins构建」的动作，未校验后续构建结果。修改trigger-jenkins-build.yml，添加构建结果校验步骤：

- name: 校验Jenkins构建状态
  uses: jenkins-zh/jenkins-client-action@v0.2.1
  with:
    url: ${{ secrets.JENKINS_URL }}
    user: ${{ secrets.JENKINS_USER }}
    token: ${{ secrets.JENKINS_TOKEN }}
    job: subbu_project
    build-number: ${{ steps.trigger.outputs.build-number }}
    wait-time: 60

此步骤会等待Jenkins构建完成，并根据结果返回Actions流程的成功或失败，避免状态不一致。

4. 强制清理Jenkins工作区 #

在Jenkins任务中添加「Delete workspace before build starts」构建步骤，强制每次构建前清理旧工作区并重新克隆代码，消除旧文件的权限残留问题。

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