使用OWASP ZAP SpiderViewStatus Java API遇UnknownHostException求助

首先咱们先理清问题的根源：

为什么会出现UnknownHostException: zap？ #

http://zap/这个地址是ZAP Docker容器的内部主机别名——如果你是在本地直接运行ZAP桌面版/独立程序，你的Java代码根本无法解析这个域名，所以必须换成ZAP实际运行的地址（比如你初始化ClientApi时用的localhost:8080）。

至于你说换成localhost:8080还是报错？大概率是两个细节没处理好：要么代码里没彻底替换URL，要么手动HTTP请求时没带上ZAP的API密钥，或者没传入scanID参数（不过你的错误栈是主机解析失败，优先排查URL问题）。

最优解决方案：继续使用ZAP官方ClientApi（推荐） #

你本来已经通过api.spider.status(scanID)完美实现了进度查询，完全没必要自己手写HttpURLConnection来调用API。官方的ClientApi已经封装了所有API请求的细节：自动处理API密钥、地址拼接、响应解析，既可靠又省心。

如果一定要手动调用HTTP API（不推荐） #

如果你坚持要自己实现HTTP请求，必须注意以下3个关键点：

1. 用正确的ZAP地址：和你初始化ClientApi时的ZAP_ADDRESS、ZAP_PORT保持一致，也就是http://localhost:8080
2. 必须带上API密钥参数：ZAP的所有API请求都需要在URL里追加apikey=你的密钥，否则会被拒绝访问
3. 传入scanID参数：spider的statusAPI需要指定扫描ID，否则无法返回对应扫描的状态

下面是修正后的代码示例：

System.out.println("Spider completed");
// 手动调用spider status API的修正代码
try {
    // 构造正确的API请求URL：带上API密钥和扫描ID
    String statusApiUrl = String.format(
        "http://%s:%d/JSON/spider/view/status/?apikey=%s&scanId=%s",
        ZAP_ADDRESS, ZAP_PORT, ZAP_API_KEY, scanID
    );
    URL obj = new URL(statusApiUrl);
    HttpURLConnection con = (HttpURLConnection) obj.openConnection();
    con.setRequestMethod("GET");
    
    int responseCode = con.getResponseCode();
    System.out.println("API响应码 : " + responseCode);
    
    BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
    String inputLine;
    StringBuffer response = new StringBuffer();
    
    while ((inputLine = in.readLine()) != null) {
        response.append(inputLine);
    }
    in.close();
    
    // 打印API返回的状态结果
    System.out.println("Spider状态详情 : " + response.toString());
} catch (Exception e) {
    System.out.println("手动调用API异常 : " + e.getMessage());
    e.printStackTrace();
}

额外排查步骤 #

如果还是有问题，试试这些验证手段：

• 打开浏览器访问http://localhost:8080，确认ZAP确实在运行
• 直接在浏览器里访问构造好的statusApiUrl，看是否能返回正常的JSON响应
• 如果是用Docker运行ZAP，确保容器的8080端口已经映射到本地，并且Java程序能访问到容器的网络地址

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