Reactor Netty HttpClient发送Multipart表单时如何自动设置Content-Length？

要解决Reactor-Netty自动设置整体Content-Length的问题，核心是让框架预计算整个Multipart表单的总内容长度，而非使用默认的流式分块传输（Transfer-Encoding: chunked）。以下是两种可行方案：

方案一：手动构建Multipart内容并计算长度 #

这种方式通过预构建完整的Multipart请求内容、计算总长度后显式设置请求头，是最可靠的实现方式：

import reactor.netty.http.client.HttpClient;
import reactor.netty.http.multipart.FilePart;
import reactor.netty.http.multipart.MultipartHttpOutputRequest;
import reactor.netty.http.multipart.MultipartWriter;

import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;

// 示例代码
public class MultipartWithContentLength {
    public static void main(String[] args) {
        String jsona = "{\"data\": \"contentA\"}";
        String jsonb = "{\"data\": \"contentB\"}";

        // 1. 创建Multipart的文件部分
        FilePart partA = FilePart.create("a", 
            new ByteArrayInputStream(jsona.getBytes(StandardCharsets.UTF_8)), 
            "application/json");
        FilePart partB = FilePart.create("b", 
            new ByteArrayInputStream(jsonb.getBytes(StandardCharsets.UTF_8)), 
            "application/json");

        // 2. 构建完整的Multipart请求
        MultipartHttpOutputRequest multipartRequest = MultipartHttpOutputRequest.create();
        multipartRequest.addFilePart(partA);
        multipartRequest.addFilePart(partB);

        // 3. 计算整个Multipart内容的总长度
        long totalLength = MultipartWriter.calculateContentLength(multipartRequest);

        // 4. 发送请求并设置Content-Length头
        HttpClient.create()
                .port(server.port())
                .post()
                .uri("/postpath")
                .header("Content-Type", "multipart/form-data; boundary=" + multipartRequest.boundary())
                .header("Content-Length", String.valueOf(totalLength))
                .send((req, out) -> out.send(multipartRequest.content()))
                .response()
                .doOnNext(resp -> {
                    // 处理响应逻辑
                })
                .block(); // 仅作示例，生产环境建议使用非阻塞操作
    }
}

方案二：禁用分块编码强制预计算长度 #

通过禁用Transfer-Encoding: chunked，让Reactor-Netty尝试预计算内容长度。注意：此方案仅适用于内容可完全加载到内存的场景，大文件场景不推荐：

import reactor.netty.http.client.HttpClient;

import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;

// 修改原代码
HttpClient.create().port(server.port()).post().uri("/postpath")
        .sendForm((req, form) -> {
            // 禁用分块编码，触发内容长度预计算
            req.requestHeaders().setTransferEncodingChunked(false);
            return form
                .multipart(true)
                .file("a", new ByteArrayInputStream(jsona.getBytes(StandardCharsets.UTF_8)), "application/json")
                .file("b", new ByteArrayInputStream(jsonb.getBytes(StandardCharsets.UTF_8)), "application/json");
        })
        .response()
        .doOnNext(resp -> {
            // 处理响应逻辑
        })
        .block();

原理说明 #

Reactor-Netty默认对Multipart表单使用流式分块传输，这是为了避免大文件场景下的内存溢出问题，因此不会自动计算整体Content-Length。而Apache HttpClient的MultipartEntityBuilder会先将所有表单内容构建为完整实体，预计算总长度后设置Content-Length头，本质是牺牲内存换来了符合服务器要求的请求格式。

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