Azure DevOps BizTalk生成管道NuGet Restore任务运行失败问题
错误详情翻译:
##[error] nuget 命令执行失败,退出代码为 1,错误信息如下:
C:\agent_work\60\s.rptproj(22411):错误 MSB4226:未能找到导入的项目C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\BizTalk\BizTalk.targets。系统也尝试在 $(MSBuildExtensionsPath) 的回退搜索路径C:\Program Files (x86)\MSBuild中查找Microsoft\BizTalk\BizTalk.targets。这些搜索路径定义在C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\bin\msbuild.exe.Config中。请确认声明中的路径正确,且文件存在于其中一个搜索路径对应的磁盘位置。
根因
该报错本质是执行管道的代理设备缺少 BizTalk 对应的构建依赖组件,MSBuild 无法加载 BizTalk 项目专属的构建目标文件,导致 NuGet 还原阶段校验项目结构失败。
解决方案
- 首先在管道代理设备上安装和开发环境版本匹配的 BizTalk Server 开发工具与 SDK,当前报错对应 VS2019 环境,需安装适配 VS2019 的 BizTalk 扩展组件
- 安装完成后校验
BizTalk.targets确实存在于报错提示的任意一个搜索路径下,默认安装后路径为C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\BizTalk\BizTalk.targets,如果路径存在差异,可以手动修改.rptproj项目文件中的导入路径,或者新增MSBuildExtensionsPath系统环境变量指向目标文件所在目录 - 如果你使用的是微软托管代理,必须替换为自托管代理,微软官方托管代理默认没有预装 BizTalk 相关构建组件,无法支持 BizTalk 项目的构建、还原操作
- 调整管道中 NuGet Restore 任务的配置,指定 MSBuild 版本为 VS2019 对应的版本,避免版本不匹配导致的搜索路径偏移问题
临时规避方案
如果暂时无法在代理设备安装 BizTalk 组件,可以修改项目文件中 BizTalk.targets 的导入语句,增加存在性判断,仅当目标文件存在时才导入,避免还原阶段报错:
<Import Project="$(MSBuildExtensionsPath)\Microsoft\BizTalk\BizTalk.targets" Condition="Exists('$(MSBuildExtensionsPath)\Microsoft\BizTalk\BizTalk.targets')" />
该方案仅适用于还原阶段不依赖 BizTalk 目标的场景,正式构建阶段仍需要安装对应组件。
内容的提问来源于stack exchange,提问作者Nikhil Deshmukh

