Go 请求返回 404 时 err 为什么还是 nil

用 http.Client.Do 请求一个不存在的资源时，服务端确实返回了 404，但 err 仍然可能是 nil。这不是 Go 漏掉了错误，而是 net/http 把“请求有没有成功完成”和“业务状态是不是 2xx”分成了两件事：只要 HTTP 对话完成，404 就作为 resp.StatusCode 返回；网络断开、协议错误或重定向策略失败，才通常进入 err。

404 是响应状态，不是传输错误

Client.Do 的返回值可以理解为两条信息：err 描述客户端是否完成了这次 HTTP 交互，resp.StatusCode 描述服务器对请求的处理结果。请求成功到达服务器，服务器也完整返回了“资源不存在”，这条链路在传输层已经完成，因此 404 并不自动等同于 Go 的 error。

所以这段代码打印出 nil 404 是符合设计的：

req, err := http.NewRequest(http.MethodGet, endpoint, nil)
if err != nil {
    return err // 请求对象都没创建好，不应继续调用 Do
}

resp, err := client.Do(req)
if err != nil {
    return err // DNS、连接、TLS、协议或重定向策略问题
}
defer resp.Body.Close() // 无论状态码是什么，都要释放响应体
fmt.Println(err, resp.StatusCode) // 404 仍可能对应 nil error

先处理 err，再读取并关闭响应体

正确的判断顺序不是“看到 404 才读取”，而是先排除没有响应对象的情况。官方文档说明：当 err 为 nil 时，resp.Body 一定非空；调用方读完后应关闭它，否则底层 Transport 可能无法复用持久连接。

读取响应体也可能失败，例如服务端提前断开或压缩流损坏。这个错误与 404 是两类事实：前者说明响应内容没有完整读出来，后者说明服务器给了一个非成功状态。不要用一个模糊的“请求失败”覆盖它们。

resp, err := client.Do(req)
if err != nil {
    return fmt.Errorf("发送 HTTP 请求: %w", err) // 此时没有可用响应可判断
}
defer resp.Body.Close()

body, err := io.ReadAll(io.LimitReader(resp.Body, 8= 300 {
    return fmt.Errorf("HTTP 状态 %s: %s", resp.Status, strings.TrimSpace(string(body)))
}
return nil

示例用 LimitReader 限制错误正文的大小，避免把一整页 HTML、代理错误页或异常响应塞进日志。正式客户端可以把上限提取成配置，并在超限时只记录“响应过长”。

把非 2xx 转成调用方真正需要的错误

如果上层只想区分“找不到”和“服务暂时不可用”，可以定义一个带状态码的错误类型。这样调用方不必解析字符串，也不会误把 404 当成网络重试信号。

type HTTPStatusError struct {
    Code int
    Status string
}

func (e *HTTPStatusError) Error() string {
    return "HTTP 请求返回 " + e.Status // 让日志保留可读状态文本
}

func checkStatus(resp *http.Response) error {
    if resp.StatusCode >= 200 && resp.StatusCode 

在调用处可以用 errors.As 判断类型：404 通常提示资源不存在，429 或 5xx 才可能进入带退避的重试策略。是否重试要结合请求是否幂等、服务端语义和业务成本，不能因为“有 error”就统一重发。

重定向与响应体读取失败要分开处理

默认客户端会按规则跟随常见重定向；如果自定义的 CheckRedirect 返回错误，Do 可能因客户端策略失败而返回 err。这和最终地址返回 404 不同：前者是客户端没有接受这次跳转，后者是客户端已经拿到了最终响应。

排查“为什么 err 还是 nil”时，可以按下面的清单复核：

结论很简单：err == nil 只说明 HTTP 请求过程没有被客户端判定为失败，不代表业务一定成功。把 err、StatusCode 和响应体读取结果分别处理，404 就不会再被误判成成功，也不会因为重复重试放大故障。

相关问答

Go 的 http.Get 返回 500 会自动报错吗？

不会。http.Get 最终也遵循 Client.Do 的状态语义，非 2xx 通常仍通过 resp.StatusCode 表示。调用方仍需关闭响应体并自行定义业务成功范围。

判断状态码前可以先 defer resp.Body.Close 吗？

可以，但前提是已经确认 err == nil 且 resp 非空。最稳妥的结构是处理完错误后立即注册 defer，再读取和判断状态。