Azure Pipelines中Whitesource Unified Agent生成HTML报告失败求助

错误原因分析 #

你遇到的参数解析错误源于两个核心问题：

1. 非法命令行参数：-out并非Unified Agent支持的参数，生成HTML报告需要使用专用的配置项。
2. 参数格式错误：Unified Agent命令行参数要求采用<key> <value>格式，仅少数缩写参数（如-c对应-config）允许使用-<key>形式。

修复方案 #

可以通过两种方式实现HTML报告的生成：

方案1：直接修改命令行参数 #

将原命令中的-out whitesource_report.html替换为启用HTML报告的参数，调整后的命令如下：

java -jar wss-unified-agent.jar -c whitesource.config generateHtmlReport true htmlReportFileName whitesource_report.html

方案2：通过环境变量配置（推荐） #

在任务的env区块中添加两个环境变量，无需修改命令行即可自动生成指定文件名的HTML报告：

env:
  # 保留原有环境变量
  WS_GENERATEHTMLREPORT: true
  WS_HTMLREPORTFILENAME: 'whitesource_report.html'

此时命令行只需保留基础启动命令：

java -jar wss-unified-agent.jar -c whitesource.config

额外注意事项 #

• PowerShell环境下，Unified Agent的配置参数（环境变量形式）必须用下划线_替代原配置中的点.，例如配置项html.report.fileName对应环境变量WS_HTMLREPORTFILENAME。
• 环境变量优先级高于whitesource.config文件中的配置，需确保两者无冲突配置。

内容的提问来源于stack exchange，提问作者Ralph Lawrence Mira