Spring RestTemplate下载大文件偶发Premature end of Content-Length报错如何确认是服务端问题

这个错误的本质是客户端实际接收的响应体字节数，小于响应头Content-Length字段声明的大小，你可以按照以下步骤逐步排查确认是否为服务侧问题：

第一步：先排除客户端自身问题 #

• 检查RestTemplate超时配置：确认你配置的connectTimeout、readTimeout时长大于该大文件的最大预期下载时长，避免客户端主动断开连接导致误判。
• 替换工具交叉验证：使用curl命令反复测试下载，命令示例：

curl -v -o temp_file 你的第三方下载URL

如果curl也偶发下载提前终止、实际下载大小小于响应头返回的Content-Length的情况，即可排除Java代码层面的问题。

第二步：捕获错误场景的核心指标定位根因 #

修改你的现有代码，增加错误时的元数据采集逻辑，修改后代码示例：

// Optional Accept header
RequestCallback requestCallback = request -> request.getHeaders()
        .setAccept(Arrays.asList(MediaType.APPLICATION_OCTET_STREAM, MediaType.ALL));

// Streams the response instead of loading it all in memory
ResponseExtractor<Void> responseExtractor = response -> {
    long contentLength = response.getHeaders().getContentLength();
    Path path = Paths.get("some/path");
    long receivedBytes = 0;
    try (InputStream inputStream = response.getBody()) {
        byte[] buffer = new byte[8192];
        int read;
        try (OutputStream os = Files.newOutputStream(path)) {
            while ((read = inputStream.read(buffer)) != -1) {
                os.write(buffer, 0, read);
                receivedBytes += read;
            }
        }
    } catch (IOException e) {
        // 出错时记录核心参数，可直接输出到日志
        System.out.printf("下载出错，预期大小：%d，实际接收：%d，响应状态码：%d%n", 
            contentLength, receivedBytes, response.getStatusCode().value());
        throw e;
    }
    // 下载完成也校验一次大小
    if (contentLength > 0 && receivedBytes != contentLength) {
        System.out.printf("下载完成但大小不匹配，预期大小：%d，实际接收：%d%n", 
            contentLength, receivedBytes);
    }
    return null;
};
restTemplate.execute(URI.create("www.something.com"), HttpMethod.GET, requestCallback, responseExtractor);

第三步：根据日志特征判定服务端问题类型 #

• Content-Length配置错误：同一个文件多次请求，返回的Content-Length值不固定，或者正常下载完成时receivedBytes和返回的Content-Length不一致，说明服务端在计算响应头时逻辑错误，比如动态生成文件未完全生成就提前返回了Content-Length。
• 服务端资源不足（内存/IO/连接耗尽）：错误集中出现在业务高峰时段，且出错时响应状态码为200、receivedBytes小于Content-Length，基本可以判定是服务端在下载过程中资源耗尽提前终止了响应，你可以把错误发生的时间点提供给第三方，让对方排查对应时间的服务错误日志，是否存在OOM、磁盘IO超限、线程池满、进程重启等记录。
• 中间代理/CDN断流：如果第三方服务前置了代理或CDN，也可能是代理层的超时配置短于下载所需时长，你可以通过加Range头分段下载验证：每次请求固定大小的片段，如果某个固定区间的片段频繁下载失败，也属于服务侧的代理配置问题。

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