Azure DevOps自托管代理部署SQL Server 2019 dacpac连接报错修复咨询

触发该报错的核心原因不是目标SQL Server的权限配置问题，是内置「SQL Server数据库部署」任务自动选用的SQLPackage版本不匹配：当前调用的140版本SQLPackage（对应SQL Server 2017及更早版本）在连接SQL Server 2019（对应150大版本体系）时，身份验证兼容逻辑存在已知缺陷，会误报“master库不存在同密码用户”的权限类错误。

方案1：直接指定高版本SQLPackage路径（改动最小，优先级最高） #

• 先在自托管代理机器上确认150版本SQLPackage可正常运行，对应路径为C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\Common7\IDE\Extensions\Microsoft\SQLDB\DAC\150\SqlPackage.exe，手动测试连接目标SQL Server 2019，验证连通性与权限配置无问题。
• 打开「SQL Server数据库部署」任务的配置页，展开「高级」配置项，在「SQLPackage.exe路径」栏直接填入上述150版本的完整路径，跳过任务自带的自动路径扫描逻辑。
• 若需要让同代理池的所有任务都匹配高版本SQLPackage，可进入代理池的代理「能力」配置页，删除原有140版本SQLPackage的识别条目，手动新增键为SqlPackage、值为150版本完整路径的能力配置，配置完成后重启自托管代理服务使配置生效。

方案2：补装系统级150版本DAC组件 #

针对系统路径下缺失C:\Program Files (x86)\Microsoft SQL Server\150\DAC文件夹的问题，直接安装SQL Server 2019对应的DAC框架运行时，安装完成后系统默认路径下会生成完整的150版本SQLPackage及关联依赖，内置任务在自动扫描路径时会优先匹配该高版本组件，无需修改单个任务的配置参数。

• 注意不要手动复制150版本的SQLPackage.exe到系统路径，单文件拷贝会因为缺失同目录下的关联DLL依赖触发运行报错。

方案3：用PowerShell任务替代内置部署任务 #

完全绕开内置「SQL Server数据库部署」任务的路径匹配逻辑，替换为PowerShell任务执行部署：

• 移除原有的SQL Server数据库部署任务，新增PowerShell任务
• 在任务脚本中硬编码150版本SQLPackage的完整路径，传入部署所需的连接、dacpac路径等参数，示例脚本如下：

# 指定150版本SQLPackage完整路径
$sqlPackageExe = "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\Common7\IDE\Extensions\Microsoft\SQLDB\DAC\150\SqlPackage.exe"
# 执行dacpac发布动作，替换为流水线中定义的实际变量参数
& $sqlPackageExe `
  /Action:Publish `
  /SourceFile:"$(部署包路径变量).dacpac" `
  /TargetConnectionString:"$(目标数据库连接字符串变量)" `
  /p:BlockOnPossibleDataLoss=False

• 禁止使用140及更早版本的SQLPackage连接SQL Server 2019及以上环境，除了当前的误报报错，还会存在dacpac结构解析异常、部署脚本生成不符合目标版本语法的问题。
• 所有涉及自托管代理能力修改的操作，完成后必须重启代理服务，否则新的配置不会被流水线任务加载。

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