Go语言中识别网络断开需通过errors.Is和errors.As判断错误类型:读到io.EOF表示对端关闭;写时errors.Is(err, net.ErrClosed)表示本地已关闭;*net.OpError结合Timeout()、Temporary()及syscall错误码可区分超时、重置或网络不可达,避免字符串匹配,实现精准错误处理。

Go 语言中识别网络断开(如连接被对端关闭、超时、底层链路中断)的关键,在于正确解读 net 包返回的错误类型和值,而不是仅靠错误字符串匹配。Go 的网络错误设计为可判断、可恢复、可分类,核心是利用 net.Error 接口和标准错误变量(如 io.EOF、net.ErrClosed)。
识别连接已关闭(对端主动断开或本地关闭)
当 TCP 连接被对端调用 close() 或 shutdown(SHUT_WR) 后,本端读取会立即返回 io.EOF;若尝试写入已关闭的连接,则通常返回 "use of closed network connection" 或 syscall.EPIPE 等底层错误。
- 读操作遇到
io.EOF:表示对端已关闭写入方向,这是正常断连信号,应清理资源并退出读循环 - 写操作返回
errors.Is(err, net.ErrClosed)或strings.Contains(err.Error(), "use of closed network connection"):说明连接已被本地显式关闭(如conn.Close()),不应再读写 - 注意:
io.EOF不是“异常”,它实现error接口但不满足net.Error,所以不能用errors.As(err, &netErr)捕获
检测连接异常中断(如断网、防火墙拦截、强制 kill)
这类错误通常在读/写时触发,表现为底层系统调用失败,错误类型多为 *net.OpError,其 Err 字段嵌套了真正的 syscall 错误(如 syscall.ECONNRESET、syscall.ETIMEDOUT、syscall.ENETUNREACH)。
- 使用
errors.As(err, &netErr)提取*net.OpError - 检查
netErr.Timeout()判断是否超时(含DeadlineExceeded) - 检查
netErr.Temporary()判断是否临时性错误(如EAGAIN、ENETDOWN,可重试) - 对
netErr.Err做 syscall 错误码比对:例如errors.Is(netErr.Err, syscall.ECONNRESET)表示连接被对端重置(常见于服务崩溃或中间设备切断)
区分超时与永久性失败
Go 的 net.Conn 支持读写 deadline,超时错误统一返回 context.DeadlineExceeded(Go 1.19+)或 *net.OpError 并满足 Timeout() == true。这不同于永久性错误(如 ECONNREFUSED、ENOTCONN)。
立即学习“go语言免费学习笔记(深入)”;
- 优先用
errors.Is(err, context.DeadlineExceeded)判断超时(最可靠) - 若需兼容旧版本,用
netErr.Timeout()+netErr.Op == "read" || netErr.Op == "write" -
errors.Is(err, syscall.ECONNREFUSED)表示目标地址拒绝连接(服务未启动),属于不可重试的永久错误 -
errors.Is(err, syscall.ENOTCONN)表示 socket 未建立连接,常出现在未conn.Write前就尝试读,或连接已失效
实用错误处理建议
避免字符串匹配,善用标准错误判断接口。一个健壮的读循环示例逻辑如下:
- 读取数据 → 若
err == io.EOF:优雅关闭 - 若
errors.Is(err, context.Canceled) || errors.Is(err, context.DeadlineExceeded):按业务决定是否重试或终止 - 若
errors.As(err, &netErr) && netErr.Timeout():记录超时,可重试(视场景) - 若
errors.Is(err, syscall.ECONNRESET) || errors.Is(err, syscall.EPIPE):连接已损坏,关闭重连 - 其他错误(如
io.ErrUnexpectedEOF、net.ErrClosed)按语义归类处理
基本上就这些。Go 的网络错误模式清晰,关键在于用对 errors.Is、errors.As 和接口断言,而非解析错误文本。










