Azure DevOps中PowerShell脚本生成DACPAC文件无输出问题

问题描述 #

我在Azure DevOps中执行一段PowerShell内联脚本用于生成DACPAC文件，脚本显示执行成功，但目标路径下找不到对应文件。该脚本在本地PowerShell客户端运行正常，脚本内容如下：

& $(SqlPackagePath) /TargetFile:$(TargetDacPacFile1) /Action:Extract /SourceServerName:$(SqlServerName1) /SourceDatabaseName:$(DbName1) /SourceUser:$(SourceUser) /SourcePassword:$(SourcePassword)

附带脚本运行日志截图及相关配置截图。

排查步骤 #

• 校验变量解析结果
  在脚本开头添加变量输出语句，确认所有Azure DevOps变量是否被正确解析：

  Write-Host "SqlPackage路径: $(SqlPackagePath)"
  Write-Host "目标DACPAC路径: $(TargetDacPacFile1)"
  Write-Host "源SQL服务器: $(SqlServerName1)"
  

  查看日志输出，检查目标路径是否存在拼写错误，或是否指向代理机器上不存在的目录。

• 确认代理账户写入权限
  Azure DevOps代理服务运行账户可能没有目标路径的写入权限，检查$(TargetDacPacFile1)对应的目录是否允许代理账户写入，必要时调整目录权限。

• 捕获SqlPackage详细执行日志
  给SqlPackage命令添加诊断参数，生成完整执行日志：

  & $(SqlPackagePath) /TargetFile:$(TargetDacPacFile1) /Action:Extract /SourceServerName:$(SqlServerName1) /SourceDatabaseName:$(DbName1) /SourceUser:$(SourceUser) /SourcePassword:$(SourcePassword) /Diagnostics:true /DiagnosticsFile:$(Agent.TempDirectory)\sqlpackage_diag.log
  

  将诊断日志作为构建工件发布，查看是否存在隐藏错误（如数据库连接异常、对象提取失败但未触发脚本错误码）。

• 确保目标目录存在
  在执行SqlPackage前添加目录检查与创建逻辑：

  $targetDir = Split-Path $(TargetDacPacFile1) -Parent
  if (-not (Test-Path $targetDir)) {
      New-Item -ItemType Directory -Path $targetDir -Force | Out-Null
      Write-Host "已创建目录: $targetDir"
  } else {
      Write-Host "目录已存在: $targetDir"
  }
  

  避免因目录不存在导致文件无法生成。

• 添加错误捕获逻辑
  PowerShell默认不会因外部命令失败终止脚本，需手动检查退出码：

  & $(SqlPackagePath) /TargetFile:$(TargetDacPacFile1) /Action:Extract /SourceServerName:$(SqlServerName1) /SourceDatabaseName:$(DbName1) /SourceUser:$(SourceUser) /SourcePassword:$(SourcePassword)
  if ($LASTEXITCODE -ne 0) {
      Write-Error "SqlPackage执行失败，退出码: $LASTEXITCODE"
      exit 1
  }
  

  确保SqlPackage实际执行失败时，脚本会抛出错误，避免误判为执行成功。

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