为何GET请求在PostMan中始终返回200，在Java应用中却返回504？

阿华AIGC实验室

2026-5-20

排查Java调用API返回504但Postman正常的问题

这种情况我之前对接第三方API时也踩过坑——看起来请求参数全一致，但就是客户端返回超时，大概率是Java客户端和Postman在底层请求细节上存在隐式差异，以下是几个重点排查方向：

1. 优先检查超时设置

504是网关超时，很可能是Java客户端的超时时间比Postman短，服务器还没处理完请求就被客户端中断了。Postman默认的超时时间通常是30秒以上，而OkHttp、Unirest这些库的默认超时可能只有10秒左右。

以OkHttp为例，手动加长超时时间试试：

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(30, TimeUnit.SECONDS)  // 连接超时
    .readTimeout(30, TimeUnit.SECONDS)     // 读取响应超时
    .writeTimeout(30, TimeUnit.SECONDS)    // 写入请求超时
    .build();

2. 核对代理配置

Postman可能自动使用了你的系统代理，或者你之前手动配置过代理，但Java客户端默认不会继承系统代理设置。如果API需要通过特定代理访问，Java里得手动配置：

比如OkHttp添加代理：

Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("your-proxy-host", 8080));
OkHttpClient client = new OkHttpClient.Builder()
    .proxy(proxy)
    .build();

也可以通过JVM参数设置全局代理：-Dhttp.proxyHost=xxx -Dhttp.proxyPort=xxx

3. 对比原始请求的字节级差异

哪怕你复制了参数和头，Java客户端可能在请求体编码、换行符、隐式头字段上和Postman有细微差别。用抓包工具（Charles、Fiddler）分别捕获Postman和Java的请求，对比以下内容：

所有请求头的字段（包括Java自动添加的Accept-Encoding、User-Agent等）
请求体的原始字节（比如是否多了空格、换行，或者编码格式不一致）
请求行的URL编码（虽然你说URL一致，但Java可能对某些字符做了二次编码）

举个例子：有些服务器对User-Agent字段敏感，Postman的默认UA和Java库的UA不一样，你可以手动把Java的UA改成和Postman完全一致试试。

4. 检查Cookie/会话状态

Postman会自动保存之前请求的Cookie，但Java客户端默认是无状态的，每次请求都是新会话。如果API需要携带特定Cookie才能正常处理（比如登录态），你得在Java请求里手动添加Cookie头，和Postman里的完全一致。

5. TLS/SSL配置差异

Postman默认支持大部分TLS版本和证书，但Java的默认配置可能更严格：

比如Java 8默认只支持到TLS 1.2，而服务器要求TLS 1.3，可以手动指定TLS版本：

ConnectionSpec spec = new ConnectionSpec.Builder(ConnectionSpec.MODERN_TLS)
    .tlsVersions(TlsVersion.TLS_1_3, TlsVersion.TLS_1_2)
    .build();

OkHttpClient client = new OkHttpClient.Builder()
    .connectionSpecs(Collections.singletonList(spec))
    .build();