更新NuGet包后构建服务器报MSB4186错误，如何解决？

错误里提到的[MSBuild]::VersionLessThanOrEquals方法是MSBuild 16.0（对应Visual Studio 2019）及以上版本才支持的API。你的构建服务器上的MSBuild版本低于这个要求，所以当项目引用了Microsoft.Extensions.ApiDescription.Server 6.0.5这个包时，它的target文件会调用这个不存在的方法，导致构建失败——哪怕你只改了一个空格，只要项目里还引用着这个包，构建时就会执行这个target，所以错误完全一致。

1. 降级NuGet包（最直接的兼容方案） #

把Microsoft.Extensions.ApiDescription.Server包降级到3.1.x系列版本（比如3.1.20），这个版本的包不会用到高版本MSBuild的方法，能适配旧版构建服务器。

操作步骤：

• 在本地项目里找到这个包，右键选择“管理NuGet程序包”
• 在“已安装”标签里找到该包，选择版本下拉框里的3.1.x版本进行安装
• 本地构建验证后提交代码

2. 升级构建服务器的MSBuild/VS版本 #

如果服务器允许升级，直接把构建服务器上的Visual Studio升级到2019或更高版本，对应的MSBuild版本会自动更新到16.0+，就能支持这个方法了。

3. 临时禁用API描述文档生成（应急方案） #

如果你不需要生成API描述文档，可以在项目的.csproj文件里添加以下配置，绕过这个报错的target：

<PropertyGroup>
  <GenerateApiDescriptionDocument>false</GenerateApiDescriptionDocument>
  <GenerateApiDescriptionDocumentOnBuild>false</GenerateApiDescriptionDocumentOnBuild>
</PropertyGroup>

添加后保存，提交代码重新构建即可。

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