推送Git标签到Bitbucket Server时，Jenkins多分支流水线任务无法自动触发怎么办

以下是逐步排查和解决的方案：

1. 检查Jenkins多分支流水线的分支源配置 #

• 进入Jenkins多分支流水线项目的配置页面，找到「分支源」模块，点击Bitbucket Server的配置项，展开「高级」选项：
  • 确保Include tags选项已勾选，可设置标签匹配规则（比如*匹配所有标签）；
  • 验证连接Bitbucket的凭据：该凭据需要拥有仓库的读权限，以及能接收Webhook事件的权限。

2. 配置Bitbucket Server的Webhook #

• 登录Bitbucket Server，进入目标仓库的「设置」→「Webhooks」，创建新Webhook：
  • 回调URL填写：http://<Jenkins服务器地址>/bitbucket-hook/（注意末尾斜杠必须保留）；
  • 触发事件必须勾选Tag created（标签创建），按需勾选其他相关事件（如推送）；
  • 点击「Test connection」测试连通性，或推送测试标签查看Webhook的请求交付记录是否成功。

3. 检查Jenkins插件与全局安全配置 #

• 确保Bitbucket Server Plugin和Multibranch Pipeline Plugin为最新版本，旧版本可能存在标签触发的兼容性Bug；
• 若Jenkins启用了CSRF保护：进入「全局安全配置」→「CSRF保护」，勾选「允许来自以下来源的POST请求」，添加Bitbucket Server的IP或域名，避免Webhook请求被拦截。

4. 验证流水线脚本与分支过滤规则 #

• 检查Jenkinsfile中的触发条件：如果存在类似when { branch 'master' }的分支限制，会排除标签触发，需调整为when { anyOf { branch 'master'; tag '*' } }来包含标签；
• 检查多分支流水线的「分支过滤」规则：确保「Exclude branches」中没有设置tags/*这类排除标签的规则。

5. 日志排查定位问题 #

• Jenkins端：进入「Manage Jenkins」→「System Log」，搜索「bitbucket」或「tag」关键字，查看是否有Webhook接收失败、标签识别错误的日志；
• Bitbucket Server端：在Webhook详情页的「Recent deliveries」中查看请求状态，若返回4xx/5xx状态码，根据错误码排查（如403为权限问题，404为URL错误）。

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