Octopus部署中使用DbUp生成HTML报告失败求助

使用Octopus Deploy部署API时，部署流程第一步需生成DBUp已执行/待执行脚本差异的HTML报告，但Octopus执行New-OctopusArtifact时报错：

'Could not find file 'C:\DeltaReports\Some API\2.9.15-DbUp-Test-9\UpgradeReport.html'.'

日志显示路径参数正常，但报告文件未生成。C#代码已用try/catch包裹，但无法确认错误是否被捕获。

1. 修复PowerShell脚本的目录创建逻辑 #

原脚本中New-Item写法错误，未指定目标路径和目录类型，导致目录实际未创建。修正为：

if (-not (Test-Path $reportPath)) {    
    New-Item -Path $reportPath -ItemType Directory -Force | Out-Null
    Write-Host "Created directory: $reportPath"
} else {
    Write-Host "Directory already exists: $reportPath"
}

-Force参数确保父目录不存在时也能递归创建，Out-Null避免输出冗余信息。

2. 检查控制台应用的退出状态 #

PowerShell默认不会因exe执行失败终止脚本，需添加退出码检查，确保exe执行失败时停止后续步骤：

& $exeToRun --connectionString="$($connectionString)" --previewReportPath="$($reportPath)"

# 检查exe执行结果
if ($LASTEXITCODE -ne 0) {
    Write-Error "DatabaseUpdater.exe exited with code $LASTEXITCODE"
    exit $LASTEXITCODE
}

3. 增强C#代码的错误日志 #

原catch块仅输出异常消息，无法定位具体错误原因，修改为输出完整异常信息：

catch (Exception ex)
{
    Console.WriteLine($"Failed to generate report: {ex.ToString()}");
    return operationError; // 确保返回非0退出码
}

ex.ToString()会包含堆栈跟踪，帮助排查是DBUp方法报错、路径权限问题还是其他IO异常。

4. 验证关键参数与权限 #

• 确认C#代码中deltaReportName的值确实是"UpgradeReport.html"，无拼写/大小写错误
• 检查Octopus运行账户对C:\DeltaReports目录的读写权限，尤其是包含空格的子目录
• 手动在部署机器上执行exe命令，验证是否能正常生成报告，排除环境问题

5. 确认DBUp报告生成逻辑 #

检查upgrader.GenerateUpgradeHtmlReport(fullReportPath)的实现：

• 该方法是否会在无待执行脚本时跳过生成报告？
• 是否存在路径拼接的隐藏问题（如特殊字符、长度限制）？

社区中不少用户遇到过Octopus artifact找不到文件的问题，常见原因包括：

• 脚本中目录创建失败
• 应用程序执行失败但未终止脚本
• 权限不足导致文件无法写入
• 命令行参数传递错误（如引号处理）

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