本文详解如何在 go 的并发 http 请求中精准识别超时错误（而非普通网络或解析错误），并可靠提取 http 响应状态码，避免将 net.error 误判为 404，提升错误处理的专业性与可观测性。
本文详解如何在 go 的并发 http 请求中精准识别超时错误（而非普通网络或解析错误），并可靠提取 http 响应状态码，避免将 net.error 误判为 404，提升错误处理的专业性与可观测性。
在 Go 中进行并发 HTTP 请求时，仅通过 err != nil 判断失败是远远不够的——它无法区分「连接超时」「读取超时」「DNS 解析失败」「服务端返回 5xx」等关键场景。尤其当使用 http.Client{Timeout: ...} 时，超时错误会以 *url.Error 包装，其底层往往嵌套 net.OpError，而后者实现了 net.Error 接口。若不显式解包并调用 Timeout() 方法，所有错误都会被一视同仁地归为“客户端失败”，导致状态码误标（如将超时记为 404）、监控失真、故障定位困难。
✅ 正确识别超时错误：使用 errors.As + net.Error.Timeout()
Go 标准库推荐使用 errors.As 进行错误类型断言（相比旧式 if err.(net.Error) != nil 更健壮，支持嵌套错误链）：
import (
"errors"
"net"
"net/http"
"time"
)
resp, err := client.Get(url)
if err != nil {
var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
// ✅ 确认为超时错误（含连接超时、读取超时等）
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0, // 或自定义超时码如 0 / -1 / 408，语义更清晰
Body: "request timeout",
})
return
}
// ❌ 其他网络错误（如 DNS 失败、拒绝连接）或非网络错误（如 URL 解析失败）
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0,
Body: fmt.Sprintf("network error: %v", err),
})
return
}
// ✅ 此时 err == nil，resp 必然有效，可安全访问 StatusCode
defer resp.Body.Close()
bodyBytes, _ := io.ReadAll(resp.Body)
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: resp.StatusCode, // 真实状态码：200/404/500/... 均原样保留
Body: string(bodyBytes),
})⚠️ 注意：resp.StatusCode 仅在 err == nil 时有效。一旦 Get() 返回非 nil 错误，resp 可能为 nil 或部分初始化，直接访问 resp.StatusCode 会导致 panic。
? 完整修复后的核心逻辑（整合进原程序）
替换原代码中 goroutine 内部的请求处理部分如下：
go func(i int, v Component) {
defer wg.Done()
resp, err := client.Get(v.Url)
if err != nil {
var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
// 明确标记超时，Status 设为 0（或业务约定的超时码）
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0,
Body: "timeout",
})
} else {
// 其他错误：DNS 失败、连接拒绝、TLS 握手失败等
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0,
Body: fmt.Sprintf("network error: %v", err),
})
}
return
}
defer resp.Body.Close()
bodyBytes, readErr := io.ReadAll(resp.Body)
if readErr != nil {
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: resp.StatusCode, // 即使读 body 失败，状态码仍有效
Body: fmt.Sprintf("read body error: %v", readErr),
})
return
}
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: resp.StatusCode,
Body: string(bodyBytes),
})
}(i, v)? 关键注意事项与最佳实践
- 不要硬编码 404 作为默认错误码：HTTP 状态码是服务端语义，客户端错误（超时、连接失败）无对应标准状态码，应使用 0、-1 或业务自定义码（如 "TIMEOUT" 字符串字段），避免污染 HTTP 语义。
- io.ReadAll 错误不影响 resp.StatusCode：只要 client.Get() 成功返回 *http.Response，StatusCode 就已确定，即使后续读取 body 失败，也应保留该状态码。
- 超时设置需权衡：http.Client.Timeout 是整个请求生命周期（DNS + 连接 + TLS + 发送 + 读取）上限。如需更细粒度控制（如仅限制读取时间），应使用 http.Transport 配置 DialContext, TLSHandshakeTimeout, ResponseHeaderTimeout, IdleConnTimeout。
- 结构体 JSON 序列化建议：为提升可读性，可将 ComponentResponse.Status 改为 int（保持数字）或增加 StatusCode 字段，并添加 StatusText 字段（如 "200 OK"），便于前端快速理解。
通过以上改造，你的聚合结果将真实反映每个组件的健康状态："Status": 200 表示成功，"Status": 500 表示服务端崩溃，"Status": 0 明确标识超时——这才是生产级可观测性的基础。
