HttpClient redirects 怎样设置重定向策略

我在用 Java 的 HttpClient 请求接口时，最容易误判的一点是：收到 3XX 并不代表客户端一定会继续访问新地址。是否自动跟随重定向，由创建客户端时的 followRedirects 策略决定。

官方文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.net.http/java/net/http/HttpClient.Redirect.html

需要可控、默认安全的行为时用 NEVER；只允许常规重定向且不接受 HTTPS 降到 HTTP 时用 NORMAL；只有明确接受所有重定向边界时才用 ALWAYS。

先把策略放在 HttpClient.Builder 上

HttpClient.Builder.followRedirects(HttpClient.Redirect) 是客户端级配置。若不调用它，按 Java SE 25 API 文档，新建客户端的默认策略是 NEVER，因此 3XX 响应会直接交给调用方处理。

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
        // 先明确重定向策略；NEVER 会保留 3XX 给业务代码判断
        .followRedirects(HttpClient.Redirect.NEVER)
        .build();

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://example.com/old-path"))
        .GET()
        .build();

HttpResponse response = client.send(
        request,
        HttpResponse.BodyHandlers.ofString());

// 状态码和 Location 由调用方决定是否继续，不把重定向当成成功正文
System.out.println(response.statusCode());
System.out.println(response.headers().firstValue("Location").orElse("没有 Location"));

策略必须在 build() 前设置，而且它属于整个 HttpClient。如果同一程序既有需要自动跟随的 GET，又有必须人工确认的请求，通常应分别创建职责清楚的客户端，而不是在发送之后临时修改策略。

NEVER、NORMAL、ALWAYS 怎么选

三个枚举值的差异可以压缩成一张判断表：

NORMAL 不是“只跟随同域名”。它的核心限制是不会从 HTTPS 自动跳到 HTTP；其他重定向仍由客户端处理。ALWAYS 的名字也不是“永远成功”，它只是放宽了重定向策略，连接失败、循环或服务端错误仍然要由请求代码处理。

一个经常被忽略的边界是请求方法：官方文档说明，自动重定向时请求方法可能随具体 30X 状态码改变，301 和 302 会把 POST 转成 GET。涉及表单提交、支付、写入或不可重复操作时，优先用 NEVER，拿到 3XX 后由业务确认新地址和是否允许重试。

用响应对象看懂最终地址和中间 3XX

启用自动跟随后，调用方拿到的 HttpResponse 通常代表最终返回的那一层。需要判断有没有发生重定向时，可以读取状态码、URI，并沿着 previousResponse() 查看之前的响应。

import java.util.Optional;
import java.net.http.HttpResponse;

// 只输出链路摘要，避免把响应体或敏感响应头写入日志
HttpResponse current = response;
int redirectCount = 0;
while (current != null) {
    System.out.printf("状态码=%d, URI=%s%n", current.statusCode(), current.uri());

    // previousResponse 返回 Optional，空值表示已经到达链路起点
    Optional> previous = current.previousResponse();
    current = previous.orElse(null);
    redirectCount++;
}

// 这里只做摘要计数，业务仍应设置自己的最大跳转和错误处理规则
System.out.println("响应链节点数=" + redirectCount);

如果策略是 NEVER，链路一般停在第一层 3XX，调用方应读取 Location 并决定是否构造下一次请求。如果策略是 NORMAL 或 ALWAYS，则可用 previousResponse() 追溯被自动处理过的前序响应。

实际项目中的选择顺序

1. 先问请求能否安全重放：GET、HEAD 等幂等读取通常更容易自动跟随；写操作先保留 3XX 更稳妥。
2. 再看协议是否允许降级：不希望 HTTPS 进入 HTTP 时选 NORMAL，不要用 ALWAYS 掩盖这一判断。
3. 最后决定是否需要中间证据：要记录每次跳转、审计 Location 或自定义限制时选 NEVER，由业务维护响应链。

调试“为什么没有跳转”时，先确认客户端确实配置了策略，再查看返回的 3XX 和 Location；调试“跳到了错误地址”时，检查是否使用了 ALWAYS、请求方法是否发生变化，以及最终响应的 uri()。

相关问题

不设置 followRedirects 时会自动跳转吗？

不会。Java SE 25 的 HttpClient 默认策略是 NEVER，需要在构建客户端前显式选择其他策略。

NORMAL 和 ALWAYS 最大区别是什么？

NORMAL 不会自动跟随 HTTPS 到 HTTP 的跳转，ALWAYS 则不排除这一协议边界。

如何知道是否经历过重定向？

查看当前响应的 statusCode() 和 uri()，再通过 previousResponse() 逐层检查前序响应。