如何解决Jenkins Generic Webhook与Git Parameter插件分支前缀不兼容问题

核心思路 #

统一两种触发方式传入的分支名格式，消除Git Parameter插件生成的前置/，无需拆分作业即可兼容手动、Webhook两种触发场景。 #

方案1：直接调整Git Parameter插件配置（根源修复，推荐） #

你使用的0.9.13版本Git Parameter插件原生支持关闭前缀/输出：

1. 进入作业参数配置页，找到对应的Git Parameter类型分支参数
2. 勾选Use Repository Relative Name（中文界面显示为「使用仓库相对名称」）
3. 保存配置后，Git Parameter输出的分支名会自动去掉前置/，和Webhook通过JSONPath提取的格式完全一致
4. Git分支说明符直接填写refs/heads/${branch}即可兼容两种触发方式

方案2：内置变量替换快速兼容（无需修改参数配置） #

如果不方便调整插件参数，可以直接在Git分支说明符处使用Jenkins内置的变量截断语法处理：

• 自由式作业直接将Git分支说明符设置为 refs/heads/${branch#/} 即可：
  • 当分支参数为/foo2/bar时，自动截断为refs/heads/foo2/bar
  • 当分支参数为foo2/bar时，无变化输出refs/heads/foo2/bar
• Pipeline作业在checkout步骤中做一次简单的字符串判断即可，示例代码：

// 归一化分支名格式
def normalized_branch = params.branch.startsWith('/') ? params.branch.substring(1) : params.branch
checkout([
    $class: 'GitSCM',
    branches: [[name: "refs/heads/${normalized_branch}"]],
    userRemoteConfigs: [[url: '你的Git仓库地址', credentialsId: '你的凭证ID']]
    // 其余Git配置保持原有设置不变
])

方案3：前置步骤参数归一化（兼容旧版本Jenkins） #

如果你的Jenkins版本不支持上述变量语法，可以在作业最前方添加一个参数处理步骤：

1. 新增「执行Shell」步骤，输入命令：

# 去除分支名开头的/，写入环境变量文件
echo "NORMALIZED_BRANCH=$(echo ${branch} | sed 's/^\///')" > branch_env.properties

2. 新增「注入环境变量」步骤，在「属性文件路径」处填写branch_env.properties
3. Git分支说明符填写refs/heads/${NORMALIZED_BRANCH}即可

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