Azure DevOps Pipeline NuGet还原后报错：缺失SSDT目标文件

问题分析 #

报错显示MSBuild找不到v11.0版本的SSDT目标文件，但你的构建环境用的是VS2019（对应v16.0），核心原因要么是自托管代理缺少SSDT组件，要么是项目或构建参数里的SSDT版本路径不匹配。

解决方案 #

1. 确保自托管代理安装了VS2019对应的SSDT组件 #

• 如果代理上装的是Visual Studio 2019：打开VS安装器，选择“修改”，在“数据存储和处理”类别下勾选SQL Server数据工具(SSDT)，完成安装。
• 如果代理上装的是Build Tools 2019：同样打开安装器，在“数据存储和处理”类别下勾选MSBuild的SQL Server数据工具，确保组件安装完整。

2. 强制指定SSDT路径到MSBuild参数 #

在现有MSBuild任务的msbuildArgs里添加SSDT路径参数，让MSBuild指向VS2019的SSDT目录：

steps:
- task: NuGetCommand@2
  displayName: 'NuGet restore'
  inputs:
    vstsFeed: 'asytrvn-uydrs124yct6'
    
- task: MSBuild@1
  displayName: 'Build Solution'
  inputs:
    solution: 'myvs.sln'
    msbuildArgs: '/p:VisualStudioVersion=16.0 /p:Configuration=Debug /p:Platform=AnyCPU /p:SSDTInstallPath="C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Microsoft\VisualStudio\v16.0\SSDT\" /t:Build'
    clean: true

注意：如果代理用的是VS2019社区/专业版，路径需要改成对应版本的安装目录，比如C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\MSBuild\Microsoft\VisualStudio\v16.0\SSDT\

3. 更新SQL项目文件的导入路径 #

打开你的.sqlproj文件，找到旧版本的SSDT导入行，把v11.0替换为v16.0，或者改用动态版本路径：

• 原导入行（示例）：

<Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v11.0\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" Condition="Exists('$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v11.0\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets')" />

• 修改后：

<Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v16.0\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" Condition="Exists('$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v16.0\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets')" />

• 更灵活的写法（推荐）：

<Import Project="$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" Condition="Exists('$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets')" />

4. 改用Azure DevOps专用SSDT构建任务 #

替换MSBuild任务为专门的SQL构建任务，它会自动处理SSDT依赖：

steps:
- task: NuGetCommand@2
  displayName: 'NuGet restore'
  inputs:
    vstsFeed: 'asytrvn-uydrs124yct6'

- task: SqlBuildTask@1
  displayName: 'Build SQL Database Project'
  inputs:
    sqlProject: '**/*.sqlproj'
    configuration: 'Debug'
    platform: 'AnyCPU'

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