使用Kotlin脚本在TeamCity应用版本设置时无法找到项目历史修订版

针对你遇到的「本地Kotlin脚本构建正常，但TeamCity同步时找不到ProjectA/B旧修订版、跳过更新到指定哈希」的问题，结合你提到的近期修改了A/B的构建配置、新增了C/D项目的背景，我整理了几个实用的排查和解决步骤：

• 核对VCS根配置与权限
  首先确认ProjectA/B关联的VCS根是否正确指向了包含它们完整历史的代码仓库——如果近期迁移过仓库、调整过路径，很容易出现根配置不匹配的情况。另外要检查TeamCity的服务账号是否有读取该仓库历史记录的权限，权限不足也会导致无法拉取旧修订信息。

• 刷新VCS缓存
  TeamCity会缓存VCS的元数据，缓存过期或不完整是这类问题的常见诱因。你可以：

  1. 进入TeamCity的「VCS Roots」页面，找到对应仓库，点击「Refresh VCS Root」或「Clear Cache」；
  2. 进入ProjectA/B的构建配置，在「VCS Settings」中手动触发一次VCS同步操作，强制TeamCity重新拉取仓库历史。

• 验证目标修订版的有效性
  确认目标哈希59a2f22ce00bdd97002d3f8c6961d619ffe925dc确实存在于ProjectA/B的仓库中。如果用的是Git，可以在本地仓库执行：

  git log --all | grep 59a2f22
  

  排查是否存在哈希拼写错误，或者该修订版被强制推送覆盖、分支被删除的情况。

• 调整配置变更与同步的顺序
  由于你刚修改了A/B的构建配置还新增了项目，可能是配置变更干扰了VCS同步流程：

  • 可以先暂时将ProjectA/B的构建配置回滚到修改前的状态，完成VCS同步更新到目标哈希后，再重新应用配置变更；
  • 也可以手动为ProjectA/B指定一个明确的、存在的基础修订版，再触发更新到目标哈希的操作。

• 查看TeamCity日志定位细节
  如果以上方法都没解决，去TeamCity服务器的日志目录（默认是<TeamCity Data Directory>/logs/teamcity-vcs.log）查看VCS相关的错误日志，里面会有更具体的失败原因，比如网络连接问题、仓库不存在、引用的远程分支已被移除等。

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