在 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 函数统一错误处理
写一个带日志和重试(可选)的通用请求函数,把错误分类记录:
立即学习“go语言免费学习笔记(深入)”;
- 对
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,它们常是客户端主动断开










