RestTemplate调用外部PHP服务遇403/302，Postman可正常请求

问题分析 #

PHP服务依赖PHPSESSID会话Cookie做权限校验，Postman会自动保存并携带该Cookie，但默认的RestTemplate不会维护Cookie状态，导致权限验证失败；添加User-Agent后触发302跳转，但跳转请求未携带会话Cookie，无法获取预期JSON响应。

解决方法 #

1. 配置RestTemplate支持Cookie会话管理 #

通过HttpComponentsClientHttpRequestFactory结合BasicCookieStore，让RestTemplate自动保存和携带Cookie（包括PHPSESSID），模拟Postman的Cookie管理行为。

首先添加Apache HttpClient依赖（若未引入）：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
</dependency>

然后配置RestTemplate Bean：

@Bean
public RestTemplate restTemplate() {
    // 用于存储会话Cookie
    BasicCookieStore cookieStore = new BasicCookieStore();
    
    HttpClient httpClient = HttpClientBuilder.create()
            .setDefaultCookieStore(cookieStore)
            .build();
    
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(httpClient);
    // 显式允许自动跟随302跳转（默认已开启，可确保兼容性）
    factory.setRedirectStrategy(new DefaultRedirectStrategy() {
        @Override
        protected boolean isRedirectable(String method) {
            return true;
        }
    });
    
    return new RestTemplate(factory);
}

2. 发起请求时匹配Postman的请求头 #

保持请求头和Postman完全一致，避免服务端的UA或其他头校验：

HttpHeaders headers = new HttpHeaders();
headers.setAccept(Collections.singletonList(MediaType.APPLICATION_JSON));
// 直接复制Postman中的User-Agent值，确保完全匹配
headers.add(HttpHeaders.USER_AGENT, "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
// 若服务端校验Referer，需添加对应来源地址
// headers.add(HttpHeaders.REFERER, "https://example.com");

HttpEntity<String> entity = new HttpEntity<>(null, headers);

String response = restTemplate.exchange(
        SERVICE_URL_INCLUDING_TOKEN,
        HttpMethod.GET,
        entity,
        String.class
).getBody();

3. 关键原理 #

• BasicCookieStore会自动保存服务端返回的Set-Cookie头中的PHPSESSID
• 302跳转后的请求会自动携带该Cookie，和Postman的会话维持逻辑一致
• 配置的DefaultRedirectStrategy确保RestTemplate跟随跳转时不丢失Cookie

额外排查技巧 #

开启RestTemplate日志，对比请求头、响应头和Postman的差异：

logging.level.org.springframework.web.client.RestTemplate=DEBUG

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