Bitbucket Webhook无法触发Jenkins任务，请求排查解决方案

我来帮你一步步排查这个问题——你已经做了不少基础配置，咱们从几个容易忽略的关键点入手：

1. 确认Jenkins Bitbucket插件的版本兼容性 #

旧版本的Bitbucket插件经常会和新版Bitbucket Server的Webhook Payload格式不兼容，导致Jenkins接收到请求后无法正确解析触发条件：

• 进入Jenkins的「插件管理」页面，找到Bitbucket插件，查看当前版本，建议升级到最新稳定版（如果你的Bitbucket Server是7.x及以上版本，插件至少要2.2.x以上）。

2. 检查Jenkins任务的分支匹配格式 #

你提到构建分支设置为「**或refs/heads/rob-jenkins」，这里可能存在格式错误：

• Jenkins的分支配置需要用英文逗号分隔多个分支规则，正确格式应该是：**,refs/heads/rob-jenkins
• 格式错误会导致Jenkins无法匹配到推送的rob-jenkins分支，自然不会触发构建。

3. 开启DEBUG日志看具体报错 #

虽然Bitbucket返回200状态码，但Jenkins内部可能有解析错误却没显示出来，你可以临时开启DEBUG日志排查：

1. 进入Jenkins的「系统管理」→「系统日志」
2. 点击「添加日志记录器」，输入com.cloudbees.jenkins.plugins.bitbucket，日志级别选择DEBUG
3. 再次推送代码到rob-jenkins分支，查看Jenkins的日志，重点看是否有「分支不匹配」「Payload解析失败」之类的提示。

4. 验证Bitbucket Webhook的Payload内容 #

有时候Webhook的Payload里的分支信息可能和你预期的不一致：

• 进入Bitbucket的Webhook设置页面，查看最近的请求记录，检查ref字段值是否为refs/heads/rob-jenkins
• 也可以点击「测试连接」，模拟一次Repo Push事件，看Jenkins是否有响应。

5. 排查Poll SCM无效的关联问题 #

你提到手动Poll SCM也无效，这说明Jenkins连主动检测分支变化都没识别到，可能的点：

• 检查Jenkins任务的SCM配置：远程仓库的名称是否为origin，分支是否填写正确（不要写成origin/rob-jenkins，直接写rob-jenkins或者refs/heads/rob-jenkins）
• 查看Poll SCM的日志，如果提示「no changes detected」，可以尝试在Jenkins任务里手动清理工作区（「构建环境」里勾选「Delete workspace before build starts」），再重新Poll。

6. 重置相关配置（解决缓存异常） #

有时候配置缓存会导致异常，你可以尝试：

• 先取消Jenkins任务里的「Build when a change is pushed to bitbucket」选项，保存任务，然后重新勾选保存
• 在Bitbucket里删除当前Webhook，重新创建一次，确保URL（http://[my jenkins url]/bitbucket-hook/）和事件（Repo Push）选择正确

如果以上步骤都试过还是不行，你可以把DEBUG日志里的关键信息贴出来，这样能更精准定位问题。

内容的提问来源于stack exchange，提问作者Rob Ormond