Jenkins与Gitlab集成时如何仅构建MR对应的源分支？

核心逻辑说明 #

你遇到的多分支构建问题是因为当前Jenkins作业未指定拉取的具体分支，默认会扫描所有远程分支的更新并触发构建，你不需要手动解析GitLab的请求报文，使用官方插件即可自动获取MR参数，按以下步骤配置即可解决：

1. 基础依赖校验 #

• 确保Jenkins已安装官方GitLab Plugin和Git Plugin，优先使用官方插件能力，无需自己解析Webhook请求体
• 进入GitLab对应项目的Webhook配置页，触发器仅勾选Merge request events，不要勾选Push events，避免代码推送时触发无关构建

2. 作业参数配置 #

GitLab插件触发构建时会自动注入MR相关的预置参数，你只需要在Jenkins作业中提前声明或直接引用即可：

• 自由风格作业：进入作业配置页，新增3个字符串类型参数，分别命名为gitlabSourceBranch、gitlabTargetBranch、gitlabMergeRequestIid
• 流水线作业：无需提前声明参数，可直接在Jenkinsfile中通过env.gitlabSourceBranch引用源分支参数

3. 源码拉取规则修改（核心配置） #

修改源码拉取的分支规则，仅拉取当前MR对应的源分支，即可避免扫描所有远程分支：

自由风格作业配置 #

• 进入「源代码管理」→「Git」→「分支构建」，将原有默认的*/**修改为${gitlabSourceBranch}
• 在「附加行为」中添加「高级克隆行为」，可按需勾选浅克隆提升拉取速度

流水线作业配置 #

直接在checkout步骤指定拉取分支为env.gitlabSourceBranch，示例代码如下：

checkout scm: [
  $class: 'GitSCM',
  branches: [[name: env.gitlabSourceBranch]],
  userRemoteConfigs: [[url: '你的Git仓库地址', credentialsId: '你的访问凭证ID']]
]

如果你使用通用Webhook触发器而非官方GitLab插件，可以在触发器配置中添加参数提取规则，从请求JSON路径$.object_attributes.source_branch获取源分支值，赋值给自定义变量后再传入拉取分支的配置即可。

4. 可选优化配置 #

你可以在作业的「构建触发器」→「GitLab触发器」中添加过滤规则，进一步减少无效构建：

• 仅允许开放状态的MR触发构建
• 配置源/目标分支的命名过滤规则，比如仅允许feature/*、bugfix/*前缀的分支触发构建
• 勾选「取消同一MR的旧版构建」，同一个MR有新提交时直接终止正在运行的旧构建，节省集群资源

配置完成后，你日志中出现的Multiple candidate revisions提示会消失，每次MR触发只会构建对应的源分支。

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