Azure DevOps经典流水线运行OWASP ZAP测试PowerShell脚本报错

故障现象 #

在Azure DevOps经典流水线中集成OWASP ZAP安全测试能力时，执行报告格式转换的PowerShell步骤触发执行失败，故障现场截图如下：

故障环节使用的PowerShell脚本原始内容如下：

$XslPath = "$($Env:SYSTEM_DEFAULTWORKINGDIRECTORY)/_CodeShare/securitytesting/OWASPToNUnit3.xslt"
$XmlInputPath = "$($Env:SYSTEM_DEFAULTWORKINGDIRECTORY)/OWASP-ZAP-Report.xml"
$XmlOutputPath = "$($Env:SYSTEM_DEFAULTWORKINGDIRECTORY)/Converted-OWASP-ZAP-Report.xml"
$XslTransform = New-Object System.Xml.Xsl.XslCompiledTransform
$XslTransform.Load($XslPath)
$XslTransform.Transform($XmlInputPath, $XmlOutputPath)

故障根因 #

结合报错信息可直接定位核心触发原因：

• 路径分隔符兼容问题：脚本全程使用/作为路径分隔符，Windows平台下PowerShell调用.NET类库加载文件时，部分版本无法正确识别该类路径格式，直接抛出文件找不到异常
• 缺少前置校验逻辑：脚本未在执行转换前校验XSLT模板、ZAP原始XML报告的存在性，出现路径异常时直接抛出底层.NET异常，无明确业务层面错误提示
• 流水线配置缺失：大概率存在两类配置问题：一是_CodeShare仓库下的XSLT模板文件未被正确拉取到代理工作目录，二是前置ZAP扫描步骤执行失败未生成原始XML报告，流程直接跳转至转换步骤触发报错

修复方案 #

替换原有PowerShell步骤内容为以下修复后的脚本即可：

# 自动适配不同操作系统路径分隔符，避免硬编码分隔符兼容问题
$XslPath = Join-Path $Env:SYSTEM_DEFAULTWORKINGDIRECTORY "_CodeShare/securitytesting/OWASPToNUnit3.xslt"
$XmlInputPath = Join-Path $Env:SYSTEM_DEFAULTWORKINGDIRECTORY "OWASP-ZAP-Report.xml"
$XmlOutputPath = Join-Path $Env:SYSTEM_DEFAULTWORKINGDIRECTORY "Converted-OWASP-ZAP-Report.xml"

# 前置文件存在性校验，抛出明确可定位的错误信息
if (-not (Test-Path $XslPath)) {
    throw "XSLT转换模板文件不存在，路径：$XslPath，请检查CodeShare工件是否正确拉取"
}
if (-not (Test-Path $XmlInputPath)) {
    throw "ZAP原始扫描报告不存在，路径：$XmlInputPath，请检查前置ZAP扫描步骤是否执行成功"
}

$XslTransform = New-Object System.Xml.Xsl.XslCompiledTransform
$XslTransform.Load($XslPath)
$XslTransform.Transform($XmlInputPath, $XmlOutputPath)

Write-Host "ZAP报告格式转换完成，输出文件路径：$XmlOutputPath"

同步需要校验的流水线配置项：

• 确认运行ZAP扫描、PowerShell转换步骤的代理作业，已配置_CodeShare所在代码仓库/工件源的拉取权限
• 确认ZAP扫描步骤和PowerShell转换步骤归属同一个代理作业，避免跨作业工作目录文件不互通
• 若使用Linux代理执行流水线，上述脚本无需修改路径格式可直接运行

内容的提问来源于stack exchange，提问作者regarding the Zap security