遇到这种现象，通常是两种客户端的默认行为差异导致网关或后端服务处理请求的方式不同，进而触发504超时。下面具体分析核心差异和解决思路：

1. 请求体传输编码方式差异 #

这是最常见的诱因：

• Apache HttpClient的StringEntity会自动计算并设置Content-Length头，请求体以普通非分块形式发送。
• Java 11原生HttpClient的BodyPublishers.ofString默认会使用分块编码（Transfer-Encoding: chunked），不会主动设置Content-Length头。

部分网关或后端服务对分块编码的支持不完善，会导致请求处理延迟甚至超时，最终返回504状态码。

解决办法：在原生请求中显式设置Content-Length头：

byte[] jsonBytes = json_string.getBytes(StandardCharsets.UTF_8);
HttpRequest request = HttpRequest.newBuilder()
    .header("Content-Type", "application/json")
    .header("Content-Length", String.valueOf(jsonBytes.length))
    .uri(URI.create(service_url))
    .POST(HttpRequest.BodyPublishers.ofByteArray(jsonBytes))
    .build();

2. 默认User-Agent头差异 #

两种客户端的默认User-Agent标识不同：

• 原生HttpClient默认值类似：Java-http-client/11
• Apache HttpClient默认值类似：Apache-HttpClient/4.5.13 (Java/11.0.16)

有些网关或后端服务会根据User-Agent做特殊逻辑处理，甚至拦截特定标识的请求。

解决办法：在原生请求中手动设置和Apache一致的User-Agent：

HttpRequest request = HttpRequest.newBuilder()
    .header("Content-Type", "application/json")
    .header("User-Agent", "Apache-HttpClient/4.5.13 (Java/11.0.16)")
    .uri(URI.create(service_url))
    .POST(HttpRequest.BodyPublishers.ofString(json_string))
    .build();

3. 超时配置差异 #

虽然两者默认都没有设置严格的超时，但原生HttpClient的同步send()方法在处理连接和响应时的超时逻辑和Apache略有不同：

• 原生HttpClient可以通过connectTimeout()和timeout()显式设置连接超时和整体请求超时
• Apache HttpClient的默认超时是无限，但实际中会受底层套接字超时的隐性影响

如果网关有严格的超时限制，原生客户端可能因为没有明确设置超时，导致请求被网关判定为超时。

解决办法：给原生HttpClient添加超时配置：

HttpClient client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10)) // 连接超时
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .header("Content-Type", "application/json")
    .uri(URI.create(service_url))
    .timeout(Duration.ofSeconds(30)) // 请求整体超时
    .POST(HttpRequest.BodyPublishers.ofString(json_string))
    .build();

4. 连接池与连接复用差异 #

Apache HttpClient默认使用连接池复用连接，而原生HttpClient的同步send()方法默认每次创建新连接。如果后端服务对连接数有限制，频繁创建新连接可能触发网关的限流或超时机制。

解决办法：给原生HttpClient配置连接池：

HttpClient client = HttpClient.newBuilder()
    .connectionPool(HttpClient.newConnectionPool())
    .build();

验证建议 #

可以通过抓包工具（比如Wireshark、Fiddler）对比两种客户端发送的请求头和请求体，就能直观看到差异，快速定位问题。

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