Go中需通过net.Error接口的Temporary()和Timeout()方法区分临时错误(可重试)与致命错误(不可重试),避免字符串匹配;临时错误包括连接拒绝、资源暂不可用、DNS失败、TCP建立超时等,致命错误如无效地址、证书验证失败、本地配置错误等。

在 Go 中,区分临时错误(temporary error)和致命错误(permanent error)对网络程序的健壮性至关重要。net 包中的错误类型提供了 Temporary() 和 Timeout() 方法,是判断错误是否可重试的核心依据。
理解 net.Error 接口
Go 标准库中,net 包的多数底层错误(如连接拒绝、超时、地址不可达等)实现了 net.Error 接口:
type Error interface {
error
Temporary() bool // 是否为临时性错误(建议重试)
Timeout() bool // 是否为超时错误(属于临时错误的子集)
}只要一个错误值实现了该接口,就可以安全调用这两个方法来判断行为策略。
常见临时错误场景与判断方式
以下错误通常返回 Temporary() == true,适合指数退避重试:
立即学习“go语言免费学习笔记(深入)”;
- 连接被拒绝(ECONNREFUSED):远端服务未启动或端口未监听,可能稍后恢复
- 资源暂时不可用(EAGAIN/EWOULDBLOCK):如文件描述符耗尽、连接数满,系统负载下降后可能恢复
- DNS 解析超时或暂时失败:DNS 服务器抖动,非域名本身失效
- TCP 连接建立超时(如 Dial timeout):网络延迟高或中间设备丢包,重试可能成功
典型致命错误特征
这些错误一般返回 Temporary() == false,重试无意义,应记录并终止或降级处理:
- 无效地址格式(如 “http://” 开头却用 tcp.Dial):属于编程错误,需修复代码
- “connection refused” 在明确知道服务已永久下线时:逻辑上不可恢复,但注意——net 包仍常将其标记为 temporary,需结合业务上下文判断
- 证书验证失败(x509: certificate signed by unknown authority):TLS 层错误,不实现 net.Error,属于 *url.Error 或 *tls.HandshakeError,需单独检查
- 本地配置错误(如绑定到已被占用的端口且不可释放):启动阶段失败,需人工干预
实用判断与重试示例
正确做法是先断言 net.Error,再结合 Temporary() 和 Timeout() 决策:
conn, err := net.Dial("tcp", "api.example.com:80", &net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
})
if err != nil {
if nerr, ok := err.(net.Error); ok {
if nerr.Temporary() {
log.Printf("临时错误,准备重试: %v", err)
// 启动带退避的重试逻辑
return retryWithBackoff(func() error {
c, e := net.Dial("tcp", "api.example.com:80", &net.Dialer{Timeout: 5 * time.Second})
conn = c
return e
})
} else if nerr.Timeout() {
log.Printf("超时错误(也是临时的): %v", err)
// 同样可重试,但可能需调整 timeout 值
}
}
// 非 net.Error 或非临时错误:记录后返回
log.Printf("致命错误,不再重试: %v", err)
return err
}注意:不要仅依赖 err.Error() 字符串匹配(如包含 “timeout” 或 “refused”),既脆弱又不符合 Go 的接口设计哲学。










