ZAP Proxy生成报告遇Missing Parameter Exception问题求助

核心排查方向 #

1. 必传参数缺失 #

ZAP的reports.generate方法存在必填参数，其中reportType（指定报告类型，如"html"、"pdf"）是必须传递的参数，不能为null。从你的代码来看，第三个参数传递了null，这是触发"Missing Parameter"异常的直接原因。

2. 参数传递顺序错误 #

Java Client API的reports.generate参数顺序是固定的，错误的参数位置会导致实际必填参数未被正确赋值。你可以对照方法签名确认参数顺序：

public ApiResponse generate(String title, String template, String reportType, String description, 
                            String contexts, String sites, String sections, String includedConfidences, 
                            String includedRisks, String filename, String reportFileNamePattern, 
                            String directory, String display) throws ClientApiException

你的代码中第三个参数对应reportType，但传了null，正好违反必填要求。

3. 参数值错误 #

你代码中传递的"targetFolder"是字符串字面量，而非之前定义的targetFolder变量，这会导致ZAP尝试将报告保存到名为targetFolder的目录，而非预期的项目根目录。

修复示例代码 #

修正上述问题后的代码如下：

@AfterMethod
public void generateZapReport() {
    String targetFolder = System.getProperty("user.dir");

    if (clientApi != null) {
        try {
            // 指定reportType为"html"，并使用变量targetFolder作为目录
            ApiResponse apiResponse = clientApi.reports.generate("WSM API Security Testing",
                    null, "html", "WSM API Security Testing", null,
                    "https://google.com.my/", null, null, null,
                    "zap-Security.html",
                    null, targetFolder, null);
            System.out.println(apiResponse);
        } catch (ClientApiException e) {
            e.printStackTrace();
        }
    }
    webDriver.quit();
}

额外验证步骤 #

• 确认ZAP服务端版本与Client API版本匹配，版本不一致可能导致参数要求变化
• 通过ZAP的API UI直接调用/JSON/reports/action/generate/端点，测试并确认必填参数的具体要求

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