登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go net/http Client.Do 返回错误时为什么仍可能有 Response

来源:17golang原创

时间:2026-11-19 04:17:19 164浏览 收藏

我第一次把 http.Client.Do 的返回值写进统一请求封装时,最容易误判的一点是:看到 err != nil,却发现 resp 似乎不是 nil。这并不意味着可以继续读取这个响应。对 Client.Do 来说,真正需要记住的是:普通错误路径上的 Response 可以忽略;只有自定义重定向策略返回错误时,才会同时看到一个非空 Response,而它的 Body 已经关闭。

官方地址:https://pkg.go.dev/net/http#Client.Do

处理顺序应当是先判断 err,再判断 HTTP 状态码。err == nil 时才把 resp.Body 当作可读取资源,并在读取完成后关闭;CheckRedirect 失败返回的旧响应只用于理解错误上下文,不要再次读取或重复关闭它。

先把 Do 的两个错误层次分开

Client.Do 返回的 error 描述的是客户端策略失败,或者根本没有成功完成 HTTP 对话,例如网络连接失败、协议错误和 CheckRedirect 返回错误。服务器返回 404、500 这类非 2xx 状态,本身不会让 Do 返回错误。

因此下面四种情况要分开处理:

情况Do 的结果Body 责任
服务器返回 404/500resp != nil、err == nil调用方读取需要的内容并关闭
连接失败或协议错误通常 resp == nil、err != nil不处理 Response
CheckRedirect 返回普通错误可能 resp != nil、err != nil返回的旧 Body 已关闭,忽略 Response
CheckRedirect 返回 ErrUseLastResponseresp != nil、err == nilBody 未关闭,由调用方关闭

为什么重定向失败时会同时有 Response 和 error

客户端收到重定向响应后,会先调用 CheckRedirect 决定是否继续请求。普通的重定向错误表示“当前响应已经拿到,但客户端策略不允许继续发起下一跳”。所以返回值中可能保留重定向前的 Response,同时把策略错误包装成 *url.Error。

这个例外很容易让封装代码写出危险分支:先判断 resp != nil,然后无论 err 是否为空都读取 resp.Body。官方契约明确说,普通 CheckRedirect 错误返回的响应体已经关闭;它不是一个可以继续消费的响应流。

Go net/http Client.Do 返回值与响应体责任的静态关系图
图1:Client.Do 返回值关系说明图,展示状态码、客户端错误、Response 和 Body 责任的静态边界,不是截图或运行证据。
package main

import (
	"fmt"
	"net/http"
)

func request(client *http.Client, req *http.Request) error {
	resp, err := client.Do(req)
	if err != nil {
		// err 非 nil 时,Response 即使非空也按契约忽略。
		return fmt.Errorf("发送请求失败: %w", err)
	}
	defer resp.Body.Close() // err 为 nil 时,Body 由调用方负责关闭。

	if resp.StatusCode = 300 {
		// HTTP 状态码是业务层判断,不等同于 Do 返回的 error。
		return fmt.Errorf("HTTP 状态异常: %s", resp.Status)
	}
	return nil
}

这里的关键不是把所有错误都吞掉,而是让错误层次保持原样:传输或策略错误走 err,服务器状态走 StatusCode。这样日志、重试和业务提示才不会把“服务器拒绝请求”误报成“网络不通”。

ErrUseLastResponse 是另一条分支

如果目标是“不跟随重定向,但仍要把这次重定向响应交给调用方”,CheckRedirect 不能返回任意错误,而应返回 http.ErrUseLastResponse。这时 Do 返回最后一个响应,err 为 nil,响应体保持打开状态。

package main

import "net/http"

func noFollowClient() *http.Client {
	return &http.Client{
		CheckRedirect: func(req *http.Request, via []*http.Request) error {
			// 保留最近一次重定向响应,让调用方读取 Location 等信息。
			return http.ErrUseLastResponse
		},
	}
}

这段配置和“返回普通错误”看起来只差一个返回值,资源语义却完全不同:前者是 err != nil 的错误路径,后者是 err == nil 的正常返回路径。后者必须像处理普通响应一样关闭 resp.Body。

响应体应该在哪个分支关闭

对通用封装来说,最稳妥的结构是“先处理 err,再注册关闭动作,最后读取和判断状态”。不要用 if resp != nil 作为进入响应处理的唯一条件,因为它无法区分已经关闭的重定向响应与可以读取的正常响应。

package main

import (
	"io"
	"net/http"
)

func readResponse(client *http.Client, req *http.Request) (int, []byte, error) {
	resp, err := client.Do(req)
	if err != nil {
		// 这里不读取 resp.Body,避免触碰 CheckRedirect 错误路径的已关闭 Body。
		return 0, nil, err
	}
	defer resp.Body.Close() // 统一覆盖普通响应与 ErrUseLastResponse。

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		// 读取失败仍由 defer 负责释放响应体。
		return resp.StatusCode, nil, err
	}
	return resp.StatusCode, body, nil
}

示例中的 io.ReadAll 只是为了演示生命周期,生产代码应根据响应大小决定是否限长读取。无论采用流式解码还是读取全部内容,Body.Close 的责任都不应因为状态码不是 2xx 而消失。

迁移旧封装时重点看这三个误区

  1. 把非 2xx 当成 Do 错误。 这会让调用方无法拿到响应头和错误正文。应在 err == nil 后单独检查状态码。
  2. 在 err 非 nil 时继续读取 resp。 普通错误不需要处理 Response;重定向策略错误返回的 Body 已关闭,继续读取只会制造二次错误。
  3. 遇到 ErrUseLastResponse 却不关闭 Body。 这个特殊值返回的是可交给调用方的最后响应,仍然需要按正常响应释放资源。
Go Client.Do 重定向策略与 Body 关闭责任的静态边界图
图2:重定向策略边界说明图,区分普通策略错误与 ErrUseLastResponse 的 Response 和 Body 生命周期。

最后用一句规则记住它

Client.Do 的 error 不是 HTTP 状态码的别名,而是客户端没有按预期完成请求的信号。普通情况下只在 err == nil 后使用 Response;自定义重定向返回普通错误时,即使 resp 非空也把它视为不可用;只有返回 ErrUseLastResponse 时,才把最后响应当作正常响应交给调用方。

如果你的封装还保留着“只要 resp != nil 就读取 Body”的写法,建议先把判断顺序改成 err -> Body.Close -> StatusCode,再根据业务决定是否重试或解析错误正文。

相关问题

HTTP 404 会让 Client.Do 返回 error 吗?

不会。非 2xx 状态本身不会触发 Do 错误,应在 err == nil 后读取状态码并按业务处理。

CheckRedirect 返回错误时还要关闭 Response.Body 吗?

普通重定向策略错误返回的旧响应体已经关闭,调用方应忽略这个 Response,不要再次读取或把它当作正常 Body 管理。

不想跟随重定向应该怎么保留响应?

让 CheckRedirect 返回 http.ErrUseLastResponse。此时 err 为 nil,返回的 Body 仍由调用方读取并关闭。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>