17370845950

应使用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()，别碰字符串。