应使用net.Error接口的Timeout()方法判断网络超时错误,而非字符串匹配;若类型断言成功且Timeout()返回true,则为超时错误,可重试,否则为永久性错误。

在Go中判断网络错误是否为超时,关键不是看错误字符串里有没有“timeout”字眼,而是用类型断言和接口方法来准确识别。
用 net.Error 接口的 Timeout() 方法
Go标准库中,大多数网络错误都实现了 net.Error 接口,它提供了一个可靠的 Timeout() 方法:
- 返回 true 表示这是超时错误(比如连接超时、读超时、写超时)
- 返回 false 表示是其他错误(如连接被拒、无路由、DNS失败等)
- 这个方法比字符串匹配稳定得多,不受系统语言、错误格式变更影响
别用字符串匹配判断超时
以下写法是错的,不推荐:
- if strings.Contains(err.Error(), "timeout") —— 错误信息可能因操作系统或Go版本不同而变化
- if err == syscall.ETIMEDOUT —— 底层错误类型不统一,且不是所有超时都映射到这个值
真正该做的是类型断言:
if nerr, ok := err.(net.Error); ok && nerr.Timeout() {
// 这是超时错误,可重试
} else {
// 其他错误,比如 connection refused、no route to host,通常不该重试
}
区分临时性错误和永久性错误
net.Error 还提供 Temporary() 方法,用于判断是否值得重试:
- Timeout() == true ⇒ 一定 Temporary() == true(超时属于典型临时错误)
- 但有些临时错误不是超时,比如临时性的资源不足(EAGAIN)、短暂的网络抖动
- 而像
connection refused、no such host这类错误,Temporary() 返回 false,一般应直接放弃
HTTP客户端场景下的超时判断
使用 http.Client 时,错误可能来自底层 net.Conn 或 http.Transport,但最终仍可统一用 net.Error 判断:
- 设置
Client.Timeout后,超时错误会包装成*url.Error,其Err字段通常是*net.OpError - 逐层 unwrap:先转
*url.Error,再取err.Err,再断言net.Error - 更简单的方式:直接用
errors.As(err, &nerr)尝试提取net.Error
示例:
var nerr net.Error
if errors.As(err, &nerr) && nerr.Timeout() {
log.Println("请求超时,准备重试")
}
基本上就这些。核心就一条:用 net.Error.Timeout(),别碰字符串。










