Java下载网站固件Zip文件异常：部分文件损坏仅75KB

你遇到的核心问题是：Java/Groovy代码下载部分固件文件时仅得到75KB的损坏内容，但浏览器可正常下载。这本质是代码发起的请求与浏览器请求存在差异，导致服务端返回了截断内容或错误响应（75KB大概率是服务端返回的错误HTML页面）。以下是具体排查和解决步骤：

1. 模拟浏览器请求头 #

多数网站会校验请求的User-Agent、Accept等头信息，非浏览器请求可能被限制。修改代码添加这些头：

URL url = new URL("https://thewebsite.com/filestore/thefile.zip");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
// 模拟Chrome浏览器请求头
conn.setRequestProperty("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36");
conn.setRequestProperty("Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8");
// 允许自动处理重定向
conn.setInstanceFollowRedirects(true);

// 用try-with-resources自动管理流，避免泄漏
try (InputStream is = conn.getInputStream();
     FileOutputStream fos = new FileOutputStream("c:\\mydownloadedfile\\thefile.zip")) {
    byte[] buffer = new byte[4096]; // 增大缓冲区提升效率
    int len;
    while ((len = is.read(buffer)) != -1) {
        fos.write(buffer, 0, len);
    }
} finally {
    conn.disconnect();
}

2. 检查响应状态与错误信息 #

在读取流前先确认响应状态，若返回非200状态码，读取错误流排查原因：

int responseCode = conn.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
    // 正常读取流逻辑
} else {
    // 读取错误流内容，查看服务端返回的具体提示
    InputStream errorStream = conn.getErrorStream();
    String errorMsg = new String(errorStream.readAllBytes(), StandardCharsets.UTF_8);
    System.err.println("下载失败，响应码：" + responseCode + "，错误信息：" + errorMsg);
}

你也可以直接用文本编辑器打开那75KB的损坏文件，如果是HTML内容，就能直接看到服务端的限制提示（比如需要登录、请求非法等）。

3. 处理Cookie会话验证 #

如果网站需要登录后才能下载，浏览器会自动携带Cookie，但Java代码默认不会保存会话。可以全局设置Cookie管理器：

// 初始化Cookie管理器，后续请求会自动保存和发送Cookie
CookieManager cookieManager = new CookieManager();
CookieHandler.setDefault(cookieManager);

如果需要登录，还得先模拟登录请求获取有效Cookie，再发起下载请求。

4. 改用专业HTTP客户端库 #

Java原生HttpURLConnection功能有限，推荐用Apache HttpClient或OkHttp这类库，它们能更稳定处理重定向、Cookie、超时等场景。比如Apache HttpClient示例：

CloseableHttpClient httpClient = HttpClients.createDefault();
HttpGet httpGet = new HttpGet("https://thewebsite.com/filestore/thefile.zip");
httpGet.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36");

try (CloseableHttpResponse response = httpClient.execute(httpGet);
     InputStream is = response.getEntity().getContent();
     FileOutputStream fos = new FileOutputStream("c:\\mydownloadedfile\\thefile.zip")) {
    byte[] buffer = new byte[4096];
    int len;
    while ((len = is.read(buffer)) != -1) {
        fos.write(buffer, 0, len);
    }
} finally {
    httpClient.close();
}

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