Apache HttpClient 5.1中如何实现POST请求以POST方式跟随重定向

方案说明 #

HttpClient 5.1版本重构了重定向相关API，移除了原有4.x版本中的LaxRedirectStrategy类，现在可以通过DefaultRedirectStrategy的构建器快速自定义重定向规则，操作简便度和4.x版本一致，无需自行实现完整的重定向策略接口。

具体实现步骤 #

1. 构建自定义重定向策略

import org.apache.hc.core5.http.HttpStatus;
import org.apache.hc.client5.http.impl.DefaultRedirectStrategy;
import org.apache.hc.client5.http.RedirectStrategy;

// 构造支持POST重定向的宽松策略
RedirectStrategy postRedirectStrategy = DefaultRedirectStrategy.builder()
    // 指定允许触发重定向的请求方法
    .allowedMethods("GET", "POST")
    // 指定需要触发重定向的响应状态码
    .redirectableStatusCodes(
        HttpStatus.SC_MOVED_PERMANENTLY, // 301
        HttpStatus.SC_MOVED_TEMPORARILY, // 302
        HttpStatus.SC_TEMPORARY_REDIRECT, // 307
        HttpStatus.SC_PERMANENT_REDIRECT // 308
    )
    // 关闭301/302响应自动将POST转为GET的默认逻辑
    .convertPostToGet(false)
    .build();

2. 将自定义策略注入HttpClient实例

import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClientBuilder;

CloseableHttpClient httpClient = HttpClientBuilder.create()
    .setRedirectStrategy(postRedirectStrategy)
    .build();

配置说明 #

• 可以根据业务需求调整allowedMethods参数，新增或移除允许重定向的请求方法
• 可以根据业务需求调整redirectableStatusCodes参数，仅保留需要处理的重定向状态码
• 若开启convertPostToGet配置，301、302响应的重定向仍会将POST转为GET，不符合需求时务必显式设为false

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