Jenkins多分支流水线排除feature/*后master无法构建的问题排查

1. 核对分支过滤规则的顺序与逻辑 #

Jenkins多分支的分支过滤是从上到下匹配，匹配到第一条规则后停止判断，这是最容易踩坑的点：

• 确保规则顺序是先包含所有分支（用通配符*），再排除feature/*，不要把排除规则放在包含规则前面
• 检查是否误将master纳入了排除范围，比如规则写了*排除后再包含master，顺序反了会导致master被过滤
• 确认匹配模式正确：feature/*是标准通配符写法，master直接写分支名即可

2. 检查分支来源的构建触发配置 #

进入多分支流水线配置页，找到「分支来源」的「高级」选项：

• 必须勾选**「扫描时构建有变更的分支」**，没勾选的话即使检测到变更也不会触发构建
• 不要勾选「仅构建已提交拉取请求的分支」这类限制选项，否则普通分支（如master）会被跳过

3. 排查Jenkinsfile的分支限制逻辑 #

查看仓库根目录的Jenkinsfile，确认没有误加限制master构建的条件：

• 检查是否存在when { not { branch 'master' } }这类反向判断
• 核对其他when条件（如变更文件范围、环境变量）是否导致master分支不满足构建要求

4. 强制刷新分支索引 #

Jenkins可能缓存了分支状态，尝试强制刷新：

• 在多分支流水线主页点击左侧的**「重新索引」**按钮，强制重新扫描所有分支
• 手动触发master分支的构建，如果能正常运行，说明是扫描触发逻辑的问题；如果也失败，排查Jenkinsfile或权限问题

5. 检查系统日志与权限 #

• 进入「管理Jenkins」→「系统日志」，搜索master分支相关的错误信息，排查是否存在权限不足、资源限制等问题
• 确认Jenkins服务账号拥有代码仓库master分支的读取权限

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