VS2017可正常构建UWP项目，Jenkins调用MSBuild报兼容错误

这问题我之前帮同事排查过类似的，核心原因就是本地VS2017的构建环境和Jenkins服务器上的环境没对齐，具体可以从这几个方向逐一排查：

1. NuGet版本不匹配 #

Visual Studio 2017自带的NuGet版本一般是4.x系列（比如4.7.1），这个版本对UAP（Universal Windows Platform）包的兼容性解析逻辑做了优化，能智能处理一些包的版本兼容声明。而Jenkins环境里如果用的是全局安装的NuGet（比如更旧的3.x版本，或者新版本但规则不同），就可能严格按照包的兼容声明判断，抛出Autofac.Extras.CommonServiceLocator 5.0.0与UAP,Version=v10.0.16299不兼容的错误。

解决方法：

• 找到VS2017自带的NuGet.exe路径（一般在C:\Program Files (x86)\Microsoft Visual Studio\2017\YourEdition\Common7\IDE\NuGet.exe），把这个文件复制到Jenkins服务器，或者在脚本里直接指定这个路径执行nuget restore；
• 或者在Jenkins脚本里强制指定NuGet版本，比如用nuget install NuGet.CommandLine -Version 4.7.1 -OutputDirectory .临时下载对应版本再使用。

2. UWP SDK版本缺失或未指定 #

本地VS2017肯定安装了UAP 10.0.16299的Windows SDK，但Jenkins服务器上可能没装这个版本，或者MSBuild默认调用了其他版本的SDK，导致包兼容性检查时不匹配。VS构建时会自动读取项目文件里指定的SDK版本并使用，但命令行MSBuild需要环境里有对应SDK才能正常识别。

解决方法：

• 在Jenkins服务器上安装Windows 10 SDK 10.0.16299；
• 在MSBuild命令里显式指定目标SDK版本，比如：

MSBuild.exe MySolution.sln /t:Clean;Build /p:Configuration=Release /p:Platform=x64 /p:WindowsTargetPlatformVersion=10.0.16299

3. 包管理方式的处理差异 #

如果你的UWP项目用的是VS2017默认的PackageReference包管理模式，而Jenkins里单独调用nuget restore可能对这种模式的支持不如MSBuild原生处理好。VS构建时会通过内置的MSBuild任务处理PackageReference的依赖恢复，而单独的nuget restore可能在兼容性检查上更严格。

解决方法：

• 去掉单独的nuget restore命令，改用MSBuild的Restore目标来处理依赖恢复，脚本改成：

MSBuild.exe MySolution.sln /t:Restore;Clean;Build /p:Configuration=Release /p:Platform=x64

这样让MSBuild自己处理依赖恢复，和VS本地构建的逻辑完全一致。

4. 未使用VS2017自带的MSBuild #

Jenkins环境里如果用的是系统全局的MSBuild.exe（比如.NET Framework自带的），而不是VS2017安装目录下的MSBuild，就会缺少VS针对UWP项目的特殊构建配置和工具链，导致兼容性检查逻辑不同。

解决方法：

• 在Jenkins脚本里指定VS2017自带的MSBuild路径，比如：

"C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe" MySolution.sln /t:Restore;Clean;Build /p:Configuration=Release /p:Platform=x64

（注意替换Enterprise为你的VS版本，比如Community或Professional）

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