Jenkins配置GitHub Webhook，如何仅触发特定分支推送构建？

嘿，我之前也踩过这个Jenkins Webhook不分分支乱触发的坑！咱们一步步来把它搞定：

第一步：检查Jenkins任务的分支配置 #

进入你的Jenkins任务，找到「源码管理」模块的Git配置区：

• 别直接写死固定分支（比如main），如果只想构建指定分支，把分支字段改成*/main（如果是多个分支可以写*/main */develop，支持通配符）；
• 一定要勾选「构建触发器」里的GitHub hook trigger for GITScm polling，这个选项是让Jenkins解析Webhook传过来的分支信息的关键，没勾的话Jenkins只会按固定分支构建。

第二步：在GitHub端过滤Webhook触发分支 #

从源头减少不必要的触发请求：

1. 打开你的GitHub仓库，进入「Settings」→「Webhooks」；
2. 找到对应Jenkins的Webhook，点击「Edit」；
3. 在「Which events would you like to trigger this webhook?」选择「Let me select individual events」，只勾选「Push」；
4. 往下拉找到「Branch filter」，填写你想要触发的分支（比如main），这样只有推送到这个分支的代码才会给Jenkins发Webhook请求。

第三步：用插件做更精确的分支触发控制（进阶） #

如果上面两步还没解决，试试「Generic Webhook Trigger」插件：

1. 先在Jenkins插件市场安装这个插件；
2. 回到任务的「构建触发器」，勾选「Generic Webhook Trigger」；
3. 配置「Post content parameters」：添加一个参数，比如ref，提取路径填$.ref（对应GitHub Webhook里的分支字段，格式是refs/heads/xxx）；
4. 设置「Trigger when expression」，比如写$ref == 'refs/heads/main'，这样只有当推送的分支是main时才触发构建；
5. 记得设置一个「Token」，确保Webhook请求的安全性。

第四步：排查插件和缓存问题 #

• 检查你的GitHub插件、Git插件是不是最新版本，旧版本可能存在分支识别的bug，更新后重启Jenkins；
• 如果配置改了还是不生效，清一下Jenkins的任务缓存，或者直接重启Jenkins试试，有时候缓存会导致配置不生效。

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