TeamCity配置求助：通配符分支名触发构建失败

问题场景 #

已配置TeamCity针对MVF-*分支自动触发构建：

• VCS根分支规则设置为+:refs/heads/MVF-*，默认分支为refs/heads/master
• VCS触发器分支过滤器配置为+:*、-:
• Bitbucket中存在MVF-JoeTestTC分支，但手动触发时提示："默认分支的构建已禁用，且构建配置无其他分支，运行构建将失败"，实际构建失败
• 当前环境：TeamCity 2023.11.1（build 147412）、Atlassian Bitbucket v6.7.1

排查与解决步骤 #

1. 强制同步分支并确认识别状态 #

TeamCity可能未自动同步Bitbucket的新分支，导致无法识别MVF-JoeTestTC：

• 进入对应VCS根的管理页面，点击**"Fetch branches"**手动触发分支拉取
• 切换到**"Branches"**标签页，确认MVF-JoeTestTC是否出现在列表中
  • 若未显示，检查Bitbucket分支权限（确保TeamCity服务账号能访问该分支），或测试VCS根连接是否正常

2. 修正VCS触发器的分支过滤器配置 #

当前+:*、-:的过滤器配置无效，且会导致TeamCity优先校验默认分支：

• 进入构建配置的**"Triggers"**页面，编辑VCS触发器
• 将分支过滤器改为+:refs/heads/MVF-*，直接指定目标分支模式，避免默认分支干扰

3. 检查构建配置的分支允许规则 #

确保构建配置允许非默认分支的构建：

• 进入构建配置的**"General Settings"**
• 找到**"Branch Filter"**（若存在），添加+:refs/heads/MVF-*到允许列表，避免排除所有分支
• 确认**"Builds in branches"**设置为允许构建非默认分支（如"Allow builds in all branches"或指定分支模式）

4. 清除TeamCity分支缓存 #

若分支已存在但仍未被识别，清除VCS相关缓存：

• 进入TeamCity后台**"Administration" > "Diagnostics" > "Clear Caches"**
• 选择清除"VCS caches"，完成后重新拉取分支

5. 验证手动分支构建 #

修改配置后，手动选择MVF-JoeTestTC分支触发构建：

• 点击构建配置的**"Run"**按钮，在分支选择器中找到并选择MVF-JoeTestTC
• 若此操作成功，说明分支识别与构建逻辑正常，只需等待VCS触发器自动触发后续分支变更

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