Jenkins接收代码推送后未触发多分支流水线构建问题求助

1. 验证Webhook的触发与送达 #

• 登录Bitbucket，进入对应项目的Webhook设置页面，查看最近交付记录：
  • 确认推送代码时是否生成了Webhook请求，若没有，检查Bitbucket的分支推送事件触发规则、仓库权限配置；
  • 若有请求但返回非200状态码，根据错误码定位问题：403为权限不足，404为Jenkins的Webhook路径错误，502为Jenkins服务不可达。
• 在Jenkins的系统管理 → 系统日志中，搜索BitbucketWebhookEndpoint关键词，确认是否收到Bitbucket的Webhook请求。若无记录，优先排查网络连通性。

2. 检查Docker容器的网络与环境 #

• 确认Jenkins容器的端口映射正确：Bitbucket服务器需能访问到Jenkins容器暴露的端口（如宿主机映射的8080端口），若为Docker内部网络，需确保Bitbucket与Jenkins在同一网络或可通过正确主机名访问。
• 同步容器时间：在Jenkins容器内执行date命令，对比Bitbucket服务器时间，时间差过大可能导致Webhook请求被插件拦截。

3. 核对Bitbucket分支源插件配置 #

• 确认多分支流水线的扫描触发器已设置为「所有推送」，且未勾选「忽略已存在分支的变更」类选项（部分插件版本存在该选项，会导致已存在分支推送不触发扫描）。
• 检查Bitbucket服务器连接配置：使用**个人访问令牌（PAT）**而非密码，确保令牌拥有仓库读取、Webhook管理权限；验证Bitbucket地址是否正确（含端口、HTTPS协议、证书信任）。

4. 插件版本兼容性校验 #

• Jenkins 2.379适配的Bitbucket Branch Source插件版本为7.0.x~7.1.x，在Jenkins插件管理中核对插件版本，若版本不匹配，尝试升级/降级至兼容版本。
• 确保Bitbucket Server Integration插件与Branch Source插件版本兼容，避免版本组合冲突。

5. Jenkins全局安全配置检查 #

• 临时关闭全局安全配置中的「防止跨站点请求伪造（CSRF）」保护（仅测试用，测试后恢复），验证是否因CSRF拦截导致Webhook请求失败；若有效，可将Bitbucket服务器IP添加至CSRF白名单。
• 确认配置Webhook的Jenkins用户拥有多分支流水线的配置权限，Bitbucket服务账号拥有Jenkins的读取权限。

最后尝试 #

若以上步骤无效，删除现有Webhook重新创建，确保触发事件勾选「仓库推送」「分支创建/删除」，HTTPS环境下勾选「启用SSL验证」。

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