本文详解如何在 go 的并发 http 请求中准确识别超时错误、区分网络错误类型，并正确提取响应状态码，避免将所有错误统一标记为 404，提升服务可观测性与容错能力。
本文详解如何在 go 的并发 http 请求中准确识别超时错误、区分网络错误类型，并正确提取响应状态码，避免将所有错误统一标记为 404，提升服务可观测性与容错能力。
在 Go 中进行 HTTP 并发调用（如“扇出”式请求聚合）时，仅依赖 err != nil 进行错误处理是远远不够的。原始代码将所有请求失败统一设为 Status: 404，这严重掩盖了真实故障语义——例如超时（timeout）、连接拒绝（connection refused）、DNS 解析失败（no such host）或服务端返回的 5xx 错误，都应被差异化记录与响应。
✅ 正确识别超时错误：使用 errors.As + net.Error
Go 标准库提供了类型安全的错误断言机制。HTTP 客户端在超时时会返回实现了 net.Error 接口的错误（如 net/http.httpError 或底层 net.OpError）。我们应使用 errors.As（推荐，自 Go 1.13 起）而非过时的类型断言 err.(net.Error)，以兼容嵌套错误（如 url.Error 包裹 net.Error）：
import (
"errors"
"net"
"net/http"
"time"
)
// ... 在 goroutine 内部 ...
resp, err := client.Get(v.Url)
if err != nil {
var netErr net.Error
if errors.As(err, &netErr) {
if netErr.Timeout() {
// ✅ 明确识别为超时错误
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0, // 或约定为 -1 / 408，表示客户端超时（非 HTTP 状态码）
Body: "request timeout",
})
return
}
// 可选：进一步区分临时性/永久性网络错误
if netErr.Temporary() {
// 如 DNS 重试失败、短暂连接中断等
}
}
// ❌ 其他非超时错误（如 DNS 失败、TLS 握手错误、无效 URL）
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0,
Body: fmt.Sprintf("network error: %v", err),
})
return
}
// ✅ 请求成功：此时 resp 一定非 nil，可安全读取 StatusCode
defer resp.Body.Close()
bodyBytes, err := io.ReadAll(resp.Body)
if err != nil {
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: resp.StatusCode, // 即使读 body 失败，状态码仍有效
Body: fmt.Sprintf("read body failed: %v", err),
})
return
}
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: resp.StatusCode, // ✅ 真实 HTTP 状态码（200, 404, 500 等）
Body: string(bodyBytes),
})⚠️ 关键注意事项
- client.Timeout 是总超时：它限制整个请求生命周期（DNS 解析 + 连接 + TLS 握手 + 发送请求 + 接收响应头），并非仅响应体读取超时。如需精细控制（如仅限制响应体读取），应使用 http.NewRequestWithContext 配合 context.WithTimeout。
- resp.StatusCode 仅在 err == nil 时有效：切勿在 err != nil 分支中访问 resp.StatusCode（此时 resp 为 nil，会导致 panic）。
- 避免全局 sync.WaitGroup 和共享切片竞态：原始代码中 cr 被多个 goroutine 并发 append，存在数据竞争。应改用带锁切片、通道收集结果，或更推荐——使用 sync.Mutex 保护写入：
var mu sync.Mutex
// ...
go func(i int, v Component) {
defer wg.Done()
// ... 请求逻辑 ...
mu.Lock()
cr = append(cr, result) // result 为 ComponentResponse
mu.Unlock()
}(i, v)- ioutil.ReadAll 已弃用：Go 1.16+ 应使用 io.ReadAll（位于 io 包），需导入 "io"。
? 总结
处理 Go HTTP 错误的核心原则是：分类识别，分层响应。
✅ 使用 errors.As(err, &netErr) 安全断言网络错误；
✅ 调用 netErr.Timeout() 精准捕获超时；
✅ 仅在 err == nil 时读取 resp.StatusCode 获取真实服务端状态；
✅ 对 Body 读取失败等子错误，保留原始 StatusCode 并附加具体原因；
✅ 并发写入共享数据结构时务必加锁或改用通道。
如此，你的聚合响应将真实反映每个组件的健康状态：{"Id":"local","Status":0,"Body":"request timeout"} 清晰表明是客户端超时，而非服务端不存在（404）或内部错误（500），为运维诊断和前端降级策略提供可靠依据。
