求助：TeamCity v2017.2.2中8个单元测试项目编译失败，缺少指定程序集

服务器重启后TeamCity构建单元测试项目时出现Microsoft.VisualStudio命名空间找不到的报错，这类问题大多和环境依赖丢失、代理配置异常有关，我给你几个针对性的排查和解决步骤：

• 检查TeamCity构建代理的VS组件识别状态
  服务器重启后，TeamCity代理可能没能正确识别已安装的Visual Studio组件。你可以登录TeamCity服务器，进入对应代理的配置页面，查看「已检测到的工具」列表里是否包含项目依赖的Visual Studio版本（比如你用的VS2017）。如果没检测到，建议修复VS安装，或者安装对应的Visual Studio Build Tools包，确保单元测试框架的程序集能被代理正常识别。

• 将单元测试框架引用改为本地文件
  很多项目会直接引用GAC中的Microsoft.VisualStudio.QualityTools.UnitTestFramework，但服务器重启后GAC的引用可能出现异常。你可以从本地VS安装目录（比如C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\PublicAssemblies）找到这个dll，复制到项目的本地lib文件夹，然后替换项目中的引用为本地文件。这样构建时就不再依赖系统GAC，稳定性会更高。

• 先初始化VS构建环境再执行编译
  重启后系统环境变量可能没正确加载VS的路径，导致MSBuild找不到单元测试框架。你可以在TeamCity的构建步骤里，先添加一个命令行步骤，执行VS的环境初始化脚本：

  "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\Tools\VsDevCmd.bat"
  

  然后再执行编译命令（比如MSBuild或dotnet build），确保构建环境是正确的。

• 清理TeamCity代理缓存
  代理的缓存文件可能在重启后损坏，导致引用解析错误。找到TeamCity代理的缓存目录（默认路径是BuildAgent\system\caches），删除其中的缓存文件，然后重启TeamCity代理服务，再重新运行构建任务。

• 指定具体的MSBuild版本
  有时候重启后TeamCity会默认使用系统自带的MSBuild版本，而非VS安装的版本，这会导致引用解析失败。你可以在构建配置的「MSBuild版本」设置里，手动指定对应VS版本的MSBuild路径，比如VS2017对应的路径是：

  C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe
  

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