Azure DevOps构建SQL数据库项目找不到SSDT targets文件报错如何解决

报错信息：C:\azagent\A1_work\r1\a_Transcripts-SQLDeployment\SampleDatabaseProject\SampleDatabaseProject\SampleDatabaseProject.sqlproj(117,3): Error MSB4019: The imported project "C:\Program Files (x86)\MSBuild\Microsoft\VisualStudio\v11.0\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" was not found. Confirm that the path in the declaration is correct, and that the file exists on disk

解决步骤 #

• 检查构建代理环境配置
  本地构建正常是因为本地VS2019预装了SQL Server Data Tools（SSDT）组件，流水线代理缺少对应组件就会触发该报错：
  • 如果你用的是自托管代理：打开Visual Studio Installer，在「数据存储和处理」工作负荷中勾选「SQL Server Data Tools」完成安装，之后重启代理服务即可。
  • 如果你用的是微软托管代理：直接选择windows-2019镜像作为构建环境，该镜像默认预装了VS2019对应版本的SSDT组件，避免使用低版本Windows镜像。
• 修正sqlproj文件的targets引用逻辑
  不要直接删除引用项，将原硬编码绑定v11.0版本的Import节点替换为动态匹配逻辑，适配不同构建环境的SSDT路径：

  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
  <Import Condition="Exists('$(SQLDBExtensionsPath)\Microsoft.Data.Tools.Schema.SqlTasks.targets')" Project="$(SQLDBExtensionsPath)\Microsoft.Data.Tools.Schema.SqlTasks.targets" />
  <Import Condition="!Exists('$(SQLDBExtensionsPath)\Microsoft.Data.Tools.Schema.SqlTasks.targets')" Project="$(MSBuildProgramFiles32)\MSBuild\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" />
  

• 调整流水线构建任务参数
  • 若使用MSBuild任务：添加构建参数 /p:VisualStudioVersion=16.0，16.0为VS2019对应的版本号，强制指定构建时调用对应版本的SSDT组件。
  • 若使用Visual Studio Build任务：在任务配置的「Visual Studio版本」选项中明确选择「Visual Studio 2019」，不要使用「最新版」这类模糊配置。
• 验证修复效果
  提交所有修改后重新触发流水线，先确认构建阶段无报错后再执行后续的部署步骤。

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