TeamCity Enterprise 2017.2.2中Git VCS根目录删除.git文件夹问题咨询

我之前在维护TeamCity构建环境时碰到过几乎一模一样的问题，结合你描述的细节（升级前正常、本地克隆仓库完全没问题），可以从这几个方向一步步排查解决：

1. 先锁定问题源头：检查元运行器的逻辑 #

首当其冲要排查那个指定元运行器的配置和脚本——毕竟问题是在执行它之后出现的：

• 仔细查看元运行器里的命令，有没有不小心加入了删除.git文件夹的操作，比如Linux/macOS下的rm -rf .git，或者Windows PowerShell里的Remove-Item -Recurse -Force .git。有时候升级元运行器或者复制脚本时会误加这类指令。
• 去TeamCity的构建日志里找这个元运行器步骤的详细输出，搜关键词.git，看看有没有相关的删除、移动记录。

2. 验证VCS根的拉取配置 #

如果元运行器没问题，就看TeamCity拉取代码的环节：

• 检查你的Git VCS根是否开启了Clean checkout选项。虽然正常情况下这个选项不会删除.git文件夹，但2017.2.2这个旧版本可能存在边缘场景的bug，临时关闭这个选项再触发一次构建试试。
• 查看VCS根的Checkout规则，有没有意外添加了-:.git这样的排除规则？虽然默认不会有，但手动修改规则时可能误操作。

3. 排查构建代理的环境干扰 #

有时候问题出在代理机器本身：

• 确认构建代理的运行用户对工作目录有完整的读写权限，会不会是权限不足导致.git文件夹被系统误删？比如Windows下代理用户没有修改目录的权限，或者Linux下目录权限被错误设置为只读。
• 检查代理机器上的第三方工具，比如杀毒软件、系统清理脚本，有没有把构建目录里的.git文件夹判定为“临时文件”自动清理？不少企业级安全软件会有这类规则。

4. 快速测试定位问题 #

可以做几个小测试缩小范围：

• 手动在构建代理的工作目录里执行git init && git remote add origin <你的仓库地址>，然后手动触发构建，看.git文件夹是否还会消失。如果消失，说明是后续步骤（比如元运行器）的问题；如果保留，说明是拉取环节的问题。
• 创建一个极简测试项目：只配置这个Git VCS根，不执行任何元运行器，触发构建后检查.git文件夹是否存在。如果存在，那问题100%出在那个元运行器上。

5. 考虑旧版本TeamCity的bug #

你用的2017.2.2版本确实比较老旧，JetBrains在后续的补丁版本（比如2017.2.5）修复了不少VCS相关的问题。如果前面的排查都没找到原因，可以尝试升级到同系列的最新补丁版本，大概率能解决这类奇怪的问题。

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