Go http.Client CheckRedirect 怎样限制重定向次数

Go 的 http.Client 默认会跟随重定向，但生产请求通常不能把跳转链交给默认行为。最直接的做法是在 CheckRedirect 中读取 via：它保存已经发出的请求，len(via) 可以用来判断下一次跳转是否超限。需要停止并报错时返回普通错误；需要把最近一次响应交给调用方时，返回 http.ErrUseLastResponse。

先把“重定向次数”和“请求总数”分开

CheckRedirect 的回调参数是即将发送的 req 和已经发出的请求列表 via。因此第一次遇到 3xx 时，len(via) 通常是 1，因为初始请求已经存在。若希望最多允许 3 次跳转，可以在 len(via) > 3 时拦截；若希望限制整条链最多发送 4 个请求，则应直接按总请求数设计判断条件。

用 len(via) 实现一个可读的硬上限

下面的策略允许最多 3 次跳转，超过后返回业务错误。注意回调发生在下一次请求发送之前，所以这个判断不会再额外发出一跳。

package main

import (
    "errors"
    "fmt"
    "net/http"
    "net/url"
)

func requestWithRedirectLimit() error {
    const maxRedirects = 3

    client := &http.Client{
        CheckRedirect: func(req *http.Request, via []*http.Request) error {
            // via 包含初始请求和已经跟随的请求；超过 3 次跳转就拒绝下一跳。
            if len(via) > maxRedirects {
                return fmt.Errorf("redirect limit exceeded: %d", maxRedirects)
            }
            // 返回 nil 才允许客户端继续跟随当前 Location。
            return nil
        },
    }

    resp, err := client.Get("https://example.com/start")
    if err != nil {
        // CheckRedirect 错误会被包装成 *url.Error，便于区分策略拒绝和网络错误。
        var urlErr *url.Error
        if errors.As(err, &urlErr) {
            return fmt.Errorf("request stopped at %s: %w", urlErr.Op, err)
        }
        return err
    }
    // 成功返回时，调用方负责关闭响应体，避免连接资源滞留。
    defer resp.Body.Close()
    return nil
}

这里的数字含义要写进代码旁边的说明，而不是只放一个魔法常量。via 的长度表示已经发出的请求数量，重定向次数则是它与初始请求之间的差值。对需要同时限制请求总量和跳转量的客户端，可以在回调中分别记录两套阈值。

普通错误和 ErrUseLastResponse 的 Body 边界不同

两种停止方式看起来都能“禁止继续跳转”，但调用方拿到的结果不同。返回普通错误时，客户端返回的前一个响应体已经关闭，适合把跳转超限当成一次失败；返回 http.ErrUseLastResponse 时，最近响应会和 nil 错误一起返回，响应体仍然打开，适合由业务读取响应头或响应体后自行决定。

import "io"

func requestAndKeepLastResponse() error {
    const maxRedirects = 3

    client := &http.Client{
        CheckRedirect: func(req *http.Request, via []*http.Request) error {
            // 到达上限后保留最近一次响应，不再发送下一次请求。
            if len(via) > maxRedirects {
                return http.ErrUseLastResponse
            }
            return nil
        },
    }

    resp, err := client.Get("https://example.com/start")
    if err != nil {
        // 网络错误或其他客户端策略错误仍然需要由调用方处理。
        return err
    }
    // ErrUseLastResponse 返回的 Body 未关闭，这里必须负责关闭并读取。
    defer resp.Body.Close()
    _, err = io.ReadAll(resp.Body)
    return err
}

第二段示例需要补充 io 导入；为了突出两种策略的差别，示例把业务动作缩成读取响应体。实际项目中还应保留重定向前后的 URL、状态码和 Location，避免只记录“请求失败”而丢掉定位线索。

排查时最容易忽略的三个点

• 超时不是跳转上限。Client.Timeout 覆盖连接、重定向和读取响应体的总时长，次数限制仍应放在 CheckRedirect。
• 不要每次请求都创建 Client。官方文档建议复用 Client 和 Transport；这样既能复用连接，也能保持跳转策略一致。
• 不要混淆服务端 3xx 和客户端策略错误。非 2xx 响应本身不会自动变成错误，真正的错误可能来自 CheckRedirect 或网络通信。

常见问题

CheckRedirect 为空时最多跟随多少次？

默认策略会在连续请求达到默认上限后停止。需要稳定的业务上限时，建议显式设置回调，不把默认值当作接口契约。

返回普通错误后还能读取前一个响应体吗？

客户端文档规定，因 CheckRedirect 返回错误而返回的前一个响应，其 Body 已关闭。若必须保留响应，请改用 http.ErrUseLastResponse 并由调用方关闭 Body。

怎样判断错误是不是重定向限制触发？

先用 errors.As 取出 *url.Error，再结合自定义错误文本或哨兵错误判断。不要仅凭 HTTP 状态码判断，因为非 2xx 状态码不一定产生 error。

把 via 的计数语义、停止方式和 Body 生命周期一起设计，重定向限制才不会变成一个只改数字却无法解释结果的回调。