Jenkins通过Git钩子触发构建时参数传递为空问题排查

开发者阿泽

2026-6-14

问题排查与解决

以下是导致PUSHEDGITTAG变量为空的常见原因及对应修复方案：

Shell特殊字符未转义：&在Shell中是后台执行的特殊符号，直接执行原curl命令时，&会被Shell解析，导致PUSHEDGITTAG=0000这部分参数没有被传递给Jenkins。
修复方式：将整个URL用双引号包裹，或者对&转义：
```
curl "http://<IP>/jenkins/job/Test/buildWithParameters?token=mytoken&PUSHEDGITTAG=0000"
# 或者
curl http://<IP>/jenkins/job/Test/buildWithParameters?token=mytoken\&PUSHEDGITTAG=0000
```
参数名称大小写不匹配：Jenkins的构建参数名区分大小写，若你在任务中创建的参数是小写（如pushedgittag），但URL中传递的是大写PUSHEDGITTAG，会导致参数无法匹配。
修复方式：进入Jenkins任务的「参数化构建过程」配置，确认参数名称与URL中传递的完全一致。
Shell步骤中变量未正确获取：少数情况下，Jenkins的环境变量未被正确导出到Shell执行环境。
修复方式：在Shell脚本中添加printenv命令，查看所有环境变量是否包含PUSHEDGITTAG；若存在，直接使用$PUSHEDGITTAG即可，无需额外语法。
权限或插件干扰：若Jenkins启用了权限控制插件（如RBAC），需确认触发构建的用户拥有「远程触发构建」和「传递参数」的权限；部分第三方插件也可能拦截参数传递。
修复方式：检查任务的权限配置，确保触发用户权限充足；暂时禁用非核心插件，测试参数是否能正常传递。