Java 11 HttpRequest设置Content-Length受限及文件上传失败问题问询

问题原因 #

1. JDK 11 内置的HttpClient默认将Content-Length列为受限请求头，禁止开发者手动设置，该限制直到Java 12才支持通过JVM参数放开，和你当前的报错场景完全匹配。
2. 直接使用HttpRequest.BodyPublishers.ofInputStream()构造请求体时，该BodyPublisher默认返回的内容长度为-1（代表未知长度），HttpClient会自动使用分块传输编码（Transfer-Encoding: chunked）发送请求，如果目标服务端不支持分块传输，就会返回500内部错误。

解决方案 #

不需要手动设置Content-Length头，只要构造BodyPublisher时提前传入已知的文件长度，HttpClient会自动生成合法的Content-Length头，完全绕开受限头限制，方案是JDK 11原生支持的，无需额外依赖。

方案1：适合大文件（不需要全量读取InputStream到内存） #

直接将ofInputStream生成的BodyPublisher包装一层，指定已知的内容长度即可：

var postRequest = HttpRequest.newBuilder()
        .POST(HttpRequest.BodyPublishers.fromPublisher(
                // 复用原有InputStream逻辑
                HttpRequest.BodyPublishers.ofInputStream(() -> inputStream),
                // 传入已知的文件长度
                inputStreamSupplier.getFileSize()
        ))
        .uri(new URI(url))
        .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_OCTET_STREAM_VALUE)
        .build();

方案2：适合小文件（InputStream可一次性读入内存） #

直接把InputStream读取为字节数组，BodyPublisher会自动计算长度并生成Content-Length头：

// 一次性读取所有字节，小文件适用
byte[] fileBytes = inputStream.readAllBytes();
var postRequest = HttpRequest.newBuilder()
        .POST(HttpRequest.BodyPublishers.ofByteArray(fileBytes))
        .uri(new URI(url))
        .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_OCTET_STREAM_VALUE)
        .build();

两种方案都不需要修改JDK版本、不需要引入第三方依赖，原生满足需求。

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