Jenkins多分支流水线：Gitlab创建MR时关闭特性分支构建

针对你遇到的Jenkins升级后，创建GitLab MR时无法自动关闭对应特性分支构建的问题，可按以下步骤排查恢复：

1. 检查GitLab多分支流水线插件核心配置 #

进入目标多分支流水线项目的配置页面，找到「Branch Sources」下的GitLab配置项，展开「Advanced」选项组：

• 确认**「Suppress automatic SCM triggering for branches that have open merge requests」**选项已勾选。该选项是插件原生支持的核心功能，作用就是当特性分支存在打开的MR时，停止该分支的自动触发构建。升级后该选项可能被重置为未勾选状态，重新勾选并保存配置即可。

2. 排查Jenkinsfile中的触发规则 #

如果插件配置没问题，检查项目的Jenkinsfile是否存在自定义触发逻辑，覆盖了插件的默认行为：

• 若Jenkinsfile中为特性分支设置了无条件触发的when规则（如下示例），会导致即使有MR存在，特性分支仍会触发构建：

  pipeline {
    agent any
    stages {
      stage('Build') {
        when {
          branch 'feature/*'
        }
        steps {
          // 构建步骤
        }
      }
    }
  }
  

• 需调整为仅在无对应MR时触发特性分支构建，利用GitLab提供的CHANGE_ID环境变量判断（该变量仅在MR构建时存在）：

  pipeline {
    agent any
    stages {
      stage('Build') {
        when {
          branch 'feature/*'
          expression {
            !env.CHANGE_ID // 仅当无MR时触发特性分支构建
          }
        }
        steps {
          // 构建步骤
        }
      }
    }
  }
  

3. 验证GitLab Webhook配置 #

登录GitLab项目的「Settings」→「Webhooks」页面：

• 确认已勾选「Push events」和「Merge request events」，且Jenkins的Webhook URL可正常接收请求。
• 点击「Test」按钮，选择「Merge request events」进行测试，确保Jenkins能正确接收并处理MR事件。

4. 检查插件与Jenkins版本兼容性 #

若以上步骤都无效，可能是升级后的GitLab多分支流水线插件与当前Jenkins核心版本不兼容：

• 查看插件的版本记录，确认当前使用的插件版本是否存在已知bug。必要时可回退到之前能正常工作的插件版本，或等待插件发布修复版本。

完成配置后，可通过以下流程验证：推送代码触发特性分支构建，创建指向dev分支的MR，观察Jenkins是否自动取消正在运行的特性分支构建；后续推送代码到该特性分支时，仅触发MR构建而不触发特性分支构建。

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