Java中RestTemplate请求超时但Postman正常，求问题排查

问题代码片段 #

String url = "https://[service-url].com/[rest-of-the-path]";
String username = "username";
String password = "password";
String auth = username + ":" + password;
String encoded = Base64.getEncoder().encodeToString(auth.getBytes(StandardCharsets.UTF_8));
HttpHeaders headers = new HttpHeaders(){{
     set("Authorization", "Basic " + encoded);
}};
RestTemplate restTemplate = new RestTemplate();
SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
requestFactory.setConnectTimeout(5000);
requestFactory.setReadTimeout(5000);
restTemplate.setRequestFactory(requestFactory);
String result = restTemplate.postForObject(url, headers, String.class);

问题描述 #

运行上述代码时，执行postForObject方法出现连接超时错误。排查过防火墙/代理可能性，但使用相同URL、用户名和密码通过Postman发起Basic认证请求能得到预期结果，因此排除代理问题。

补充说明 #

• 尝试过Unirest、HttpUrlConnection等其他HTTP客户端，均出现相同的连接超时问题
• 几乎同时在Java本地服务和Postman中发起请求，Java服务报错而Postman请求正常
• 使用Java 8，无法升级到更高版本

1. 请求体传递错误 #

你的代码直接把HttpHeaders作为postForObject的请求体参数，但POST请求需要明确区分请求头和请求体。Postman发送POST请求时默认会携带请求体（哪怕是空的），而你的代码相当于把请求头当成了请求内容发送，服务端可能因未收到预期格式的请求而挂起连接，最终导致超时。

解决方法：用HttpEntity包装请求头和请求体（空请求体也需要明确传递）：

HttpEntity<String> requestEntity = new HttpEntity<>(null, headers);
String result = restTemplate.postForObject(url, requestEntity, String.class);

2. Java 8 TLS版本兼容性问题 #

部分服务要求使用TLS 1.2或更高版本，Java 8默认的TLS配置可能未启用对应版本，而Postman默认支持高版本TLS，因此能正常连接。

解决方法：强制Java使用TLS 1.2，可在代码开头添加：

System.setProperty("https.protocols", "TLSv1.2");

或者在JVM启动参数中加入：-Dhttps.protocols=TLSv1.2

3. SSL证书信任问题 #

Postman会自动信任多数证书，但Java的系统信任库可能未包含目标服务的SSL证书，导致连接时证书验证卡住，最终表现为超时（部分场景不会直接抛出证书错误）。

解决方法：

• 测试环境临时方案（不建议生产使用）：忽略证书验证，需要引入Apache HttpClient依赖：

TrustStrategy acceptingTrustStrategy = (X509Certificate[] chain, String authType) -> true;
SSLContext sslContext = SSLContexts.custom().loadTrustMaterial(null, acceptingTrustStrategy).build();
SSLConnectionSocketFactory csf = new SSLConnectionSocketFactory(sslContext);
CloseableHttpClient httpClient = HttpClients.custom().setSSLSocketFactory(csf).build();
HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
requestFactory.setConnectTimeout(5000);
requestFactory.setReadTimeout(5000);
RestTemplate restTemplate = new RestTemplate(requestFactory);

• 生产环境方案：将目标服务的SSL证书导入Java的系统信任库（cacerts文件）

4. 请求头缺失关键字段 #

Postman会自动添加一些默认请求头（如Content-Type、User-Agent），而你的代码仅设置了Authorization，服务端可能因缺少必要请求头而不响应，导致超时。

解决方法：补充常见请求头：

headers.setContentType(MediaType.APPLICATION_JSON);
headers.set("User-Agent", "Mozilla/5.0");

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