Spring Boot中RestTemplate处理POST请求302重定向问题咨询

一、RestTemplate默认的302重定向行为 #

RestTemplate默认会处理302重定向，但有个关键限制：当POST请求返回302时，它会自动将请求方法转为GET，并丢弃原POST的请求体和部分请求头。这是因为DefaultRedirectStrategy的默认逻辑认为，重定向后的请求应该用GET方法（符合HTTP规范中部分场景的约定），但这在登录这类需要保留POST参数的场景下会导致问题。

默认重定向次数上限为3次，超过会抛出HttpClientErrorException。

二、如何跟随302并保留原请求逻辑（获取重定向响应体） #

如果需要保持POST方法、携带原请求参数或会话Cookie来获取重定向后的响应体，需要做以下配置：

1. 自定义重定向策略，保留原请求方法

继承DefaultRedirectStrategy，重写getRedirectedRequest方法，让重定向请求沿用原HTTP方法：

import org.springframework.http.HttpMethod;
import org.springframework.http.client.DefaultRedirectStrategy;
import org.springframework.http.client.ClientHttpRequest;
import org.springframework.http.client.ClientHttpResponse;

import java.io.IOException;

public class PreserveMethodRedirectStrategy extends DefaultRedirectStrategy {
    @Override
    protected HttpMethod getRedirectedRequest(HttpMethod method, ClientHttpResponse response) throws IOException {
        // 保留原请求方法，不强制转为GET
        return method;
    }
}

2. 配置RestTemplate使用自定义策略

将自定义策略绑定到RestTemplate的请求工厂：

RestTemplate restTemplate = new RestTemplate();
SimpleClientHttpRequestFactory requestFactory = (SimpleClientHttpRequestFactory) restTemplate.getRequestFactory();

// 应用自定义重定向策略
requestFactory.setRedirectStrategy(new PreserveMethodRedirectStrategy());
// 可调整最大重定向次数，默认3次
requestFactory.setMaxRedirects(5);

3. （可选）管理会话Cookie，适配登录场景

如果重定向后的接口需要携带登录会话Cookie，建议使用HttpComponentsClientHttpRequestFactory（需引入Apache HttpClient依赖），它能自动管理Cookie：

首先引入Maven依赖：

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

然后配置带Cookie管理的RestTemplate：

import org.apache.http.impl.client.BasicCookieStore;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;

// 初始化Cookie存储，自动保存和发送会话Cookie
BasicCookieStore cookieStore = new BasicCookieStore();
CloseableHttpClient httpClient = HttpClients.custom()
        .setDefaultCookieStore(cookieStore)
        .build();

HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
// 绑定自定义重定向策略
requestFactory.setRedirectStrategy(new PreserveMethodRedirectStrategy());

RestTemplate restTemplate = new RestTemplate(requestFactory);

三、总结 #

• 默认行为：POST请求遇302会转GET，丢失请求体，仅适用于无状态的重定向场景；
• 自定义重定向策略：解决POST转GET的问题，保留原请求方法和参数；
• HttpClient请求工厂：适配需要会话保持的场景，自动管理Cookie，确保重定向后的请求携带登录状态。

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