如何在Bitbucket中仅合并请求时触发构建，失败则阻止合并？

核心思路 #

通过自定义Pipeline触发规则+合并检查，实现仅在点击合并PR的瞬间触发构建验证，PR期间代码更新不会自动触发构建，且构建失败直接阻止合并。

具体操作步骤 #

1. 关闭PR自动构建触发
   进入仓库设置 → Pipelines → Settings，取消勾选「Trigger pipelines for pull requests」。这样PR创建或期间代码推送时，不会自动跑构建，避免不必要的耗时。

2. 定义合并专用验证Pipeline
   在项目根目录的bitbucket-pipelines.yml里，添加一个自定义Pipeline，专门用于合并前的构建验证：

   pipelines:
     custom:
       merge-validation:
         - step:
             name: 合并前构建&测试验证
             script:
               - # 替换成你的项目构建命令，比如 mvn clean install（Java）、npm run build && npm test（前端）
             caches:
               - maven # 或node等，根据项目类型配置缓存，缩短构建时间
   

3. 配置合并强制检查
   进入仓库设置 → Pull requests → Merge checks，添加「Build pipeline」检查项，选择你刚才定义的merge-validation自定义Pipeline，并勾选「Required for merge」。

实际效果 #

• PR期间开发者推送代码，不会触发任何自动构建；
• 当开发者点击PR的「Merge」按钮时，Bitbucket会自动启动merge-validation Pipeline；
• 若构建/测试失败，合并流程会被直接阻断，页面会提示构建失败原因，必须修复后重新触发验证；
• 构建通过后，才能完成PR合并。

额外优化 #

如果开发者想在合并前提前自测，可以在PR页面的「Pipelines」标签下，手动选择运行merge-validation Pipeline，提前发现问题，避免合并时卡壳。

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