Go http.Client CheckRedirect 返回错误后如何读取上一跳响应

在 Go 中禁止某次 HTTP 重定向时，很多人会在 CheckRedirect 里返回自定义错误，然后在调用方看到 resp != nil 就继续读取 resp.Body。这一步通常会得到空内容或读取错误，因为普通错误路径下，上一跳响应的 Body 已经被 http.Client 关闭。

如果目标是“停止重定向并保留上一跳响应供调用方读取”，应返回 http.ErrUseLastResponse，而不是普通错误。此时返回的 err 为 nil，调用方负责读取并关闭 Body。

这个语义来自 Go net/http Client 文档，不是某个版本的偶然行为。

普通错误为什么拿不到上一跳正文

CheckRedirect 接收的是“准备发送的下一跳请求”和已经发出的请求列表 via，它本身没有一个 resp 参数。若回调返回普通错误，客户端停止发送下一跳请求，同时把上一跳 Response 和包装后的 *url.Error 返回给调用方。

client := &http.Client{
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
        // 这里决定是否继续，但不能从参数直接读取上一跳响应正文。
        return errors.New("redirect is not allowed")
    },
}

resp, err := client.Get(startURL)
if err != nil {
    // resp 可能非空，但普通错误路径上的 Body 已由 Client 关闭。
    if resp != nil {
        _ = resp.Body.Close()
    }
    return err
}

因此，普通错误适合表达“策略拒绝”或“重定向失败”，不适合表达“我还要读取上一跳响应”。即使再次调用 Close 通常也不会造成问题，但它不能把已经关闭的 Body 变回可读状态。

用 ErrUseLastResponse 保留上一跳响应

需要读取状态码、响应头或正文时，把回调改为返回 http.ErrUseLastResponse。这是 Client 约定的哨兵错误：客户端不再发下一跳请求，返回最近一次响应，并保持它的 Body 未关闭。

client := &http.Client{
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
        // 停止重定向，同时把当前响应交还给调用方处理。
        return http.ErrUseLastResponse
    },
}

resp, err := client.Get(startURL)
if err != nil {
    return fmt.Errorf("request redirect policy: %w", err)
}
defer resp.Body.Close() // ErrUseLastResponse 路径由调用方关闭 Body

body, err := io.ReadAll(io.LimitReader(resp.Body, 64

注意这里不是“返回了一个会被 errors.Is 捕获的普通错误”。Client 识别这个特定值后，会把它转换成 resp, nil。所以调用方应先判断 err，再在成功分支关闭和读取 Body。

读取后再转换成自己的业务错误

如果业务仍然希望上层收到“禁止重定向”的错误，可以先保留响应、读取必要信息，再自己封装错误。正文不宜无限读取，尤其是重定向响应可能来自外部服务。

func getWithoutRedirect(url string) (*http.Response, error) {
    client := &http.Client{
        CheckRedirect: func(req *http.Request, via []*http.Request) error {
            // 先保留上一跳，业务层读取后再决定错误类型。
            return http.ErrUseLastResponse
        },
    }

    resp, err := client.Get(url)
    if err != nil {
        return nil, err
    }
    return resp, nil // 调用方拥有 resp.Body 的关闭责任
}

resp, err := getWithoutRedirect(startURL)
if err != nil {
    return err
}
defer resp.Body.Close()

body, readErr := io.ReadAll(io.LimitReader(resp.Body, 64= 300 && resp.StatusCode 

这里的关键是责任只有一份：函数返回可读响应后，由当前调用方负责 Close；如果读取失败，也不能省略关闭。生产代码还可以只保留必要的响应头，把正文截断到固定大小，避免把错误页全部写入日志。

认证头和跨主机重定向的边界

CheckRedirect 更适合做“是否允许继续”的策略判断，而不是读取上一跳内容的钩子。若需求是根据上一跳响应正文做决策，应改用 ErrUseLastResponse 后在调用方判断，或在更底层的传输层记录所需信息。

还要注意，重定向到不同主机时，Authorization 等敏感头不应默认复制。即便在 CheckRedirect 中手动添加，也应先比较目标主机、协议和信任边界，避免把凭据带到不应访问的地址。

常见延伸问题

返回 3xx 会自动报错吗？ 不会。只有重定向策略或网络协议处理失败才会返回错误；如果停止策略使用 ErrUseLastResponse，调用方会得到非空响应和空错误。

为什么看到 resp 非空还要判断 err？ 因为普通 CheckRedirect 错误可以同时返回二者，但此时 Body 已关闭。若要读取正文，应从源头改用 ErrUseLastResponse。

记住这一条即可：普通错误代表“请求没有继续”，ErrUseLastResponse 代表“停止继续，并把上一跳资源交给我”。