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/500 | resp != nil、err == nil | 调用方读取需要的内容并关闭 |
| 连接失败或协议错误 | 通常 resp == nil、err != nil | 不处理 Response |
| CheckRedirect 返回普通错误 | 可能 resp != nil、err != nil | 返回的旧 Body 已关闭,忽略 Response |
CheckRedirect 返回 ErrUseLastResponse | resp != nil、err == nil | Body 未关闭,由调用方关闭 |
为什么重定向失败时会同时有 Response 和 error
客户端收到重定向响应后,会先调用 CheckRedirect 决定是否继续请求。普通的重定向错误表示“当前响应已经拿到,但客户端策略不允许继续发起下一跳”。所以返回值中可能保留重定向前的 Response,同时把策略错误包装成 *url.Error。
这个例外很容易让封装代码写出危险分支:先判断 resp != nil,然后无论 err 是否为空都读取 resp.Body。官方契约明确说,普通 CheckRedirect 错误返回的响应体已经关闭;它不是一个可以继续消费的响应流。

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 而消失。
迁移旧封装时重点看这三个误区
- 把非 2xx 当成 Do 错误。 这会让调用方无法拿到响应头和错误正文。应在
err == nil后单独检查状态码。 - 在 err 非 nil 时继续读取 resp。 普通错误不需要处理 Response;重定向策略错误返回的 Body 已关闭,继续读取只会制造二次错误。
- 遇到 ErrUseLastResponse 却不关闭 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 仍由调用方读取并关闭。
-
278 收藏
-
479 收藏
-
483 收藏
-
291 收藏
-
195 收藏
-
Golang · Go问答 | 24分钟前 | 标准库 · Context · 并发控制 · net/http · Go问答 · Go 请求超时 handler 取消信号 ErrHandlerTimeout Request.Context http.TimeoutHandler311 收藏
-
389 收藏
-
Golang · Go问答 | 33分钟前 | 网络编程 · TCP · Go问答 · Go KeepAliveConfig SetKeepAlivePeriod net.TCPConn.SetKeepAlive TCP keep-alive474 收藏
-
181 收藏
-
339 收藏
-
Golang · Go问答 | 51分钟前 | 文件处理 · csv · Go问答 · 错误排查 · Go encoding/csv csv.Reader CSV读取 FieldsPerRecord ErrFieldCount210 收藏
-
170 收藏
-
440 收藏
-
128 收藏
-
Golang · Go问答 | 58分钟前 | JSON · 类型转换 · Go问答 · encoding/json · Go encoding/json json.Unmarshal float64 json.Number JSON数字 Decoder.UseNumber397 收藏
-
333 收藏
-
295 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习