如何在Golang中捕获网络请求异常_统一输出错误日志

在 Go 中捕获网络请求异常需显式传递 error、结构化记录上下文、避免 panic 泄露，并封装可复用请求逻辑；须双重检查 resp 和 err，defer/recover 仅用于顶层 handler，按错误类型分级日志（ERROR/WARN/INFO）。

在 Go 中捕获网络请求异常并统一输出错误日志，关键在于：把 error 显式传递、用结构化日志记录上下文、避免 panic 泄露、封装可复用的请求逻辑。

用 defer + recover 拦截 panic（慎用）

标准库的 http.Client 本身不会 panic，但业务代码中若手动调用 panic() 或访问空指针，可能触发崩溃。可在 HTTP handler 中加一层保护：

• 只在顶层 handler（如 http.HandleFunc 包裹的函数）里用 defer/recover，不建议在每个请求内部嵌套
• recover 后应记录完整堆栈，并返回 500 响应，不能静默吞掉
• 示例：
  defer func() {
    if r := recover(); r != nil {
      log.Printf("[PANIC] %v\n%v", r, debug.Stack())
      http.Error(w, "Internal error", http.StatusInternalServerError)
    }
  }()

检查 resp 和 err 双重判断（必须做）

Go 的 HTTP 请求必须同时检查 resp 和 err，因为即使 err == nil，resp.StatusCode 也可能非 2xx（比如 404、502）：

• 先判断 err != nil：处理连接失败、超时、DNS 错误等底层异常
• 再判断 resp.StatusCode = 300：处理业务级 HTTP 错误
• 记得 resp.Body.Close()，否则会泄漏连接（哪怕出错也要关）

封装 request 函数统一错误处理

写一个带日志和重试（可选）的通用请求函数，把错误分类记录：

• 对 url.Error 提取 Err 和 Timeout() 判断是否超时
• 对 *http.Response 记录状态码、URL、耗时、响应头大小等上下文
• 用结构化日志（如 zap 或 log/slog）输出，字段包括：method、url、status、duration_ms、error
• 示例字段：
  logger.Error("http request failed",
    slog.String("url", u.String()),
    slog.Int("status", resp.StatusCode),
    &slog.Duration("duration", time.Since(start)),
    slog.String("err", err.Error()))

区分错误类型做分级日志

不是所有错误都要记 ERROR 级别。按影响程度分级记录更利于排查：

• ERROR：连接拒绝、TLS 协议错误、超时 —— 表示服务不可达或配置问题
• WARN：404、401、403 —— 属于预期中的业务响应，但需监控突增
• INFO：2xx 成功请求（可选，用于审计或采样）
• 避免把 io.EOF 或 context.Canceled 当作错误打 ERROR，它们常是客户端主动断开