Jenkins Pipeline无法被Bitbucket Server推送/PR触发，但Freestyle项目正常

针对你遇到的Freestyle项目正常触发、Pipeline项目无响应的情况，可按以下步骤排查解决：

1. 核对Pipeline项目的触发器配置 #

• 确保Pipeline项目中已勾选「Bitbucket Push and Pull Request Trigger」，而非其他类型的Webhook触发器。
• 检查分支过滤规则：如果设置了分支匹配（比如仅匹配master），确认合并操作对应的分支（如合并后推送的master）符合规则，可临时改为通配符*测试是否能触发。
• 确认触发器中选择的Bitbucket Server实例、仓库路径，与正常触发的Freestyle项目完全一致（注意路径大小写，部分系统会区分）。

2. 排查Pipeline的分支逻辑 #

• 若使用Jenkinsfile，检查是否存在分支条件判断导致构建跳过，比如if (env.BRANCH_NAME != 'master') return这类代码，需确认env.BRANCH_NAME环境变量是否正确传递。
• 查看Pipeline项目的构建历史，是否有「已触发但被跳过」的记录；进入项目日志，查看是否有触发后未执行的具体原因。

3. 验证插件兼容性与配置细节 #

• 尝试升级Bitbucket Push and Pull Request插件到最新稳定版（当前2.8.4版本可能与Jenkins 2.427存在兼容问题，升级前建议备份Jenkins配置）。
• 确认Git插件配置：检查Pipeline项目的源码管理中，Git仓库的URL、凭证与Freestyle项目一致，测试连接是否正常。

4. 查看详细日志定位问题 #

• 开启Jenkins DEBUG日志：进入「系统管理→系统日志→添加日志记录器」，添加com.cloudbees.jenkins.plugins.bitbucket和jenkins.plugins.git的DEBUG级别日志，重新触发Webhook后，查看日志中是否有Pipeline项目被匹配的记录，或是否存在权限、分支匹配失败等错误。
• 检查Bitbucket Webhook历史：在Bitbucket的Webhook设置中查看请求详情，确认payload中的分支、事件类型（如合并PR的pullrequest:merged）是否符合Pipeline触发器的勾选事件。

5. 排查权限问题 #

• 确认Jenkins连接Bitbucket的账号，对目标仓库拥有读写权限及PR查看权限，权限不足可能导致插件无法解析事件。
• 检查Pipeline项目的权限设置，确保Webhook使用的账号（或匿名用户）拥有触发该项目的权限。

6. 测试极简Pipeline #

• 创建一个仅包含「Bitbucket触发器」和echo 'Test Trigger'步骤的极简Pipeline项目，不设置分支过滤，测试推送或合并操作。若能触发，说明原Pipeline的配置存在问题，逐步添加原有配置进行排查。

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