手动构建时无法选择特定VCS分支的问题咨询

这问题我之前帮好几个用户排查过，核心是TeamCity手动分支下拉列表和触发器识别分支的逻辑完全不同：触发器是实时扫描VCS变更，而手动分支列表依赖VCS Root的分支缓存或Build Configuration的分支过滤规则。给你列几个最可能的原因和解决步骤：

1. VCS分支缓存未同步 #

TeamCity为了性能，会缓存VCS分支列表，不会实时拉取所有分支。如果feature-234是刚推送的，缓存还没刷新就会看不到：

• 进入对应的VCS Root配置页面，点击右上角【Actions】→【Fetch all branches】手动触发缓存刷新；
• 也可以等10-15分钟，TeamCity默认会定期同步分支缓存（你也能在VCS Root的【Advanced Settings】里调整同步间隔）。

2. Build Configuration的分支规格过滤了该分支 #

别搞混了！触发器的+:*是控制自动触发的，但手动分支列表受Build Configuration本身的分支规格控制：

• 进入Build Configuration的【Version Control Settings】；
• 找到【Branch Specifications】（分支规格），如果这里的规则不是+:*，或者没有明确包含feature-234（比如规则是+:feature-*3*），那这个分支就会被过滤出手动列表；
• 把分支规格改成+:*（或者添加+:feature-234），保存后刷新Build页面，就能看到该分支了。

3. 分支被标记为隐藏/归档 #

如果你的VCS（比如Git）里feature-234被设为归档分支，或者TeamCity里标记了隐藏：

• 检查Git仓库的分支状态，确保它是活跃分支；
• 进入TeamCity的【VCS Roots】→对应Root的【Branches】页面，看看feature-234有没有被勾选“Hidden”，取消勾选即可。

4. 权限问题（概率较低） #

虽然触发器能触发说明权限基本没问题，但还是可以确认下：

• 确保当前操作Build Configuration的用户账号，有权限访问feature-234分支；
• 检查VCS Root的【Permissions】设置，确认相关用户/组有覆盖所有分支的“Read”权限。

总结 #

大概率是分支缓存未更新或者Build Configuration分支规格设置错误，先排查这两个点，基本能解决问题。

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