Java自定义HTTP请求如何设置Map<String,List>类型请求头

java.net.http 原生包实现方式 #

java.net.http.HttpRequest.Builder 没有提供直接接收Map<String, List<String>>类型请求头集合的内置API，但是可以通过遍历Map批量调用头设置方法实现等效需求，不需要引入第三方依赖。
针对你当前的代码，批量设置头的逻辑如下：

Map<String, List<String>> headerMap = // 你的自定义请求头Map

HttpRequest.Builder builder = HttpRequest.newBuilder()
        // 注意原代码此处缺少URI.create的右括号，已修正
        .uri(URI.create(targetUrl))
        .method(myMethod, HttpRequest.BodyPublishers.ofString(body));

// 批量写入头
headerMap.forEach((headerName, headerValues) -> {
    // 先清空同名已有头，和单值setHeader的覆盖逻辑保持一致
    builder.setHeader(headerName, "");
    // 逐个追加多值头
    headerValues.forEach(value -> builder.header(headerName, value));
});

HttpRequest request = builder.build();

如果要保持原有链式调用的写法，可以封装一个简单的工具方法：

private static HttpRequest.Builder applyHeaders(HttpRequest.Builder builder, Map<String, List<String>> headers) {
    headers.forEach((k, vs) -> {
        builder.setHeader(k, "");
        vs.forEach(v -> builder.header(k, v));
    });
    return builder;
}

封装后调用方式和原生API一致：

HttpRequest request = applyHeaders(
        HttpRequest.newBuilder()
                .uri(URI.create(targetUrl))
                .method(myMethod, HttpRequest.BodyPublishers.ofString(body)),
        headerMap
).build();

如果你的请求头是单值的Map<String, String>类型，遍历逻辑更简单，直接循环调用setHeader即可。

支持原生传入头Map的其他HTTP客户端 #

如果不想手动实现遍历逻辑，常用的第三方HTTP客户端都原生支持批量传入头Map：

• OkHttp：可以通过Headers.of()方法直接接收Map类型的头集合，传入构建器即可完成批量配置，自动适配多值头场景
• Apache HttpClient 5.x：请求构建器内置setHeaders方法，支持直接传入头集合、头数组，无需手动遍历处理
• Spring WebClient：Spring生态下的响应式HTTP客户端，构建请求时可通过.headers()方法直接接收已封装好的头Map对象，一行代码即可完成批量配置

内容的提问来源于stack exchange，提问作者Dr Drake Ramoray