本文详解如何在 go 的 http 客户端中准确识别超时错误、区分网络异常类型，并正确提取响应状态码，避免将所有错误统一标记为 404，提升并发请求的健壮性与可观测性。
本文详解如何在 go 的 http 客户端中准确识别超时错误、区分网络异常类型，并正确提取响应状态码，避免将所有错误统一标记为 404，提升并发请求的健壮性与可观测性。
在 Go 中发起并发 HTTP 请求时，仅依赖 err != nil 判断失败是远远不够的——它无法区分「连接超时」「读取超时」「DNS 解析失败」「服务端返回 5xx」等关键场景。尤其当使用 http.Client{Timeout: ...} 时，超时错误会以 net.Error 形式返回，但其底层类型并非 *url.Error 或 *http.ProtocolError，直接字符串匹配（如检查 "timeout"）既脆弱又不符合 Go 的错误处理哲学。
✅ 正确做法是：使用 errors.As 动态断言错误是否实现了 net.Error 接口，并调用其 Timeout() 方法。这是 Go 官方推荐的、类型安全的错误分类方式。
以下是对原代码的关键改进点与完整重构示例：
✅ 1. 精准识别超时错误（而非字符串匹配）
import (
"errors"
"net"
// ... 其他导入
)
// 在 goroutine 内部处理响应
resp, err := client.Get(v.Url)
if err != nil {
var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
// 明确归类为超时：状态码设为 0（语义清晰），Body 记录超时信息
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: 0, // 非标准 HTTP 状态码，表示客户端超时
Body: "request timeout",
})
return
}
// 其他网络错误（如 DNS 失败、拒绝连接等）
cr = append(cr, ComponentResponse{
Id: v.Id,
Status: -1, // 自定义错误码，表示非超时网络异常
Body: fmt.Sprintf("network error: %v", err),
})
return
}✅ 2. 正确获取并透传真实 HTTP 状态码
当 err == nil 时，resp.StatusCode 即为服务端返回的真实状态码（如 200, 404, 500），无需硬编码为 404：
defer resp.Body.Close()
bodyBytes, err := io.ReadAll(resp.Body) // 替换已弃用的 ioutil.ReadAll
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, // ✅ 真实状态码
Body: string(bodyBytes),
})✅ 3. 其他关键优化建议
- 使用 io.ReadAll 替代 ioutil.ReadAll：ioutil 已在 Go 1.16+ 中弃用；
- 避免全局变量 overallStatus：并发写入存在竞态；应改为统计 cr 中失败项数量后动态设置；
- 添加上下文控制（进阶）：对单个请求使用 context.WithTimeout 可实现更细粒度的取消控制；
- 结构体字段导出规范：确保 JSON 序列化字段名与结构体标签一致（原代码中 ComponentResponse.Id 和 Status 均为大写首字母，符合导出要求，无需修改）。
? 总结
| 场景 | 推荐处理方式 | 状态码建议 |
|---|---|---|
| 请求超时（net.Error.Timeout()） | 明确记录为超时，不混淆为服务端错误 | 0 |
| 其他网络错误（DNS、连接拒绝等） | 单独归类，便于监控和告警 | -1 |
| HTTP 响应成功（err == nil） | 直接使用 resp.StatusCode | 实际值（200/404/500...） |
| 读取响应体失败 | 保留 resp.StatusCode，Body 记录读取错误 | 实际值 |
通过以上改造，你的聚合结果将真正反映各组件的真实健康状态，例如：
{
"Status": "success",
"Components": [
{"Id":"local","Status":0,"Body":"request timeout"},
{"Id":"google","Status":200,"Body":"<!doctype html>..."},
{"Id":"integralist","Status":500,"Body":"Internal Server Error"}
]
}这不仅提升了诊断效率，也为后续熔断、重试、告警策略奠定了坚实基础。
