Go中网络错误处理需显式检查error值,优先断言net.Error以利用Timeout()和Temporary()判断重试时机,再用errors.Is识别具体错误类型,配合超时控制与指数退避策略,并记录完整上下文日志。
在 Go 中处理网络错误,核心是理解 error 类型的返回机制和常见网络错误的分类,而不是用“异常”(Go 没有 try/catch)。网络操作(如 net.Dial、http.Get、listener.Accept())失败时均返回 error 值,需显式检查并针对性处理。
Go 的标准库将底层网络错误封装为 net.Error 接口,它比普通 error 多两个方法:Timeout() 和 Temporary()。这对重试逻辑至关重要:
示例:
conn, err := net.Dial("tcp", "example.com:80", timeout)
if err != nil {
if nerr, ok := err.(net.Error); ok {
if nerr.Timeout() {
log.Println("连接超时,准备重试...")
// 可加入退避重试逻辑
}
if nerr.Temporary() {
log.Println("临时错误,稍后重试")
}
} else {
log.Printf("非网络错误:%v", err)
}
return
}
实际开发中,需识别具体错误原因以便决策。常用方式是用 errors.Is 或字符串匹配(注意:后者不推荐用于生产,仅作快速判断):
errors.Is(err, syscall.ECONNREFUSED):连接被拒绝(服务未启动)errors.Is(err, syscall.ENETUNREACH):网络不可达(如目标主机离线或路由问题)errors.Is(err, context.DeadlineExceeded):上下文超时(常用于带 context.WithTimeout 的 HTTP 请求)url.Error:HTTP 请求中包装的底层错误(如 DNS 解析失败、TLS 握手失败),可通过 err.Unwrap() 获取原始错误示例(HTTP 请求错误处理):
resp, err := http.DefaultClient.Do(req)
if err != nil {
var urlErr *url.Error
if errors.As(err, &urlErr) {
if errors.Is(urlErr.Err, context.DeadlineExceeded) {
log.Println("HTTP 请求超时")
} else if errors.Is(urlErr.Err, syscall.ECONNREFUSED) {
log.Println("目标服务未响应")
}
}
return
}多数网络错误源于配置不当。应避免无超时的阻塞调用:
context.WithTimeout 控制整个请求生命周期http.Client 设置 Timeout、Transport 的 DialContext 和 ResponseHeaderTimeout
github.com/cenkalti/backoff/v4),避免雪崩简单手动重试示例:
for i := 0; i < 3; i++ {
conn, err := net.DialTimeout("tcp", addr, 2*time.Second)
if err == nil {
return conn, nil
}
if !isTemporaryNetworkError(err) {
return nil, err // 非临时错误,不重试
}
time.Sleep(time.Second * time.Duration(1<日志记录与可观测性建议
网络错误日志应包含足够上下文,便于排查:
fmt.Sprintf("%T", err))、错误值(err.Error())ECONNREFUSED)考虑告警,而非静默重试避免只写 log.Println(err) —— 它丢失了错误结构和上下文。