Go 中网络超时错误是 net.Error 接口实例，需用类型断言 + Timeout() 判断；HTTP 客户端由 http.Client 自动处理，而 TCP/UDP 或自定义协议需手动重试，推荐指数退避与 deadline 控制。
Go 语言中网络超时错误不是独立类型，而是 net.Error 接口的实例，关键看其 Timeout() 方法返回值。识别超时后是否重连，取决于场景——HTTP 客户端通常由 http.Client 自动处理（如设置 Timeout 或各阶段超时），而底层 TCP/UDP 连接、自定义协议或长连接则需手动判断并实现重试逻辑。
识别 net.Error 是否为超时
所有 标准库 网络操作（net.Dial、conn.Read、conn.Write、listener.Accept 等）出错时，若底层是系统超时（如 connect timeout、read timeout），错误会满足 net.Error 接口，并且 Timeout() 返回 true。
- 不要用字符串匹配（如检查 error.Error() 是否含 “timeout”），不可靠且不跨平台
- 正确做法是类型断言：
if ne, ok := err.(net.Error); ok && ne.Timeout() {
// 这是超时错误
}
注意：某些非标准库封装（如第三方 HTTP 客户端）可能不遵循该约定，需查阅其文档。
立即学习“go 语言免费学习笔记（深入）”；
区分不同阶段的超时类型
超时发生在不同环节，处理策略不同：
- 连接建立超时（DialTimeout）：说明服务不可达或 防火墙 拦截，适合立即重试（带退避）或切换备用地址
- 读超时（SetReadDeadline）：可能服务响应慢、网络抖动或半开连接，可重试请求（若幂等）或主动关闭连接
- 写超时（SetWriteDeadline）：较少见，通常意味着对端接收异常或网络拥塞，建议关闭连接并重建
- Keep-alive 超时或心跳失败：应视为连接失效，需重连而非重发数据
简单可靠的重连机制示例
适用于 TCP 长连接客户端（如对接设备、消息中间件）：
- 使用指数退避（exponential backoff），避免雪崩重连；初始延迟 100ms，每次翻倍，上限 5s
- 重连前清除旧连接（
conn.Close()），防止文件描述符泄漏 - 设置合理的连接与读写 deadline，避免单次阻塞过久
- 限制最大重试次数（如 5 次），失败后返回错误，由上层决定是否告警或降级
// 示例片段：
for i := 0; i conn, err := net.Dial(“tcp”, addr)
if err == nil {
conn.SetReadDeadline(time.Now().Add(5 * time.Second))
return conn, nil
}
if ne, ok := err.(net.Error); ok && ne.Timeout() {
time.Sleep(backoff(i)) // 如 time.Duration(100*math.Pow(2, float64(i))) * time.Millisecond
continue
}
return nil, err
}
HTTP 场景下无需手动重连
标准 http.Client 已内置超时控制和连接复用，推荐直接配置而非自行重试：
- 设置
Client.Timeout控制整个请求生命周期（含 DNS、连接、写入、读取） - 更精细控制可用
Transport的DialContext+SetDeadline，或分别设Timeout、IdleConnTimeout、TLSHandshakeTimeout等 - 注意：HTTP 默认不自动重试 5xx（除 429/503 外），幂等 GET/HEAD 可考虑用中间件重试，但 POST 不建议盲目重发
基本上就这些。核心是别把超时当普通错误忽略，也别一概重试——先识别、再分场景、最后按需恢复连接或上报。
