为何Job DSL生成的Jenkins多分支Pipeline分支不匹配，保存后自动修复？

问题原因 #

你遇到的问题本质是Job DSL生成的配置缺少Branch API插件的标识属性，导致Jenkins无法正确识别分支源类型，进而无法匹配任何分支。

具体来说，Jenkins的多分支Pipeline依赖Branch API插件处理分支扫描逻辑，<sources>标签必须携带plugin属性声明对应的插件版本，这样Jenkins才能调用正确的插件逻辑处理分支源。但Job DSL 1.84版本在生成多分支任务时，没有自动给<sources>标签添加这个属性，导致分支扫描逻辑无法正常触发。而手动保存配置时，Jenkins的UI会自动补全这个缺失的属性，让Branch API插件能正常工作，所以扫描就正常了。

解决方案：修改Job DSL脚本添加插件属性 #

你需要在Job DSL脚本中通过configure块手动给<sources>标签添加plugin属性，指定你当前使用的Branch API插件版本。示例代码如下：

multibranchPipelineJob('你的多分支任务名称') {
  branchSources {
    branchSource {
      source {
        git {
          remote('你的Git仓库地址')
          credentialsId('你的凭据ID')
          includes('*') // 匹配所有分支，可根据需求调整
        }
      }
    }
  }
  // 手动添加sources标签的plugin属性
  configure { node ->
    node / sources {
      attribute('plugin', 'branch-api@2.1122.v09cb_8ea_8a_724')
    }
  }
}

这段代码里的configure块直接操作生成的XML配置节点，给<sources>标签补上缺失的plugin属性，值就是你当前安装的Branch API插件版本号。

注意事项 #

• 确保plugin属性中的版本号和你实际安装的Branch API插件版本完全一致，避免版本不匹配导致的问题。
• 修改后的Job DSL脚本生成任务后，无需再手动保存配置，直接执行分支扫描就能匹配到所有符合条件的分支。

内容的提问来源于stack exchange，提问作者John Q Citizen