本文详解如何使用 errors.Is 和 errors.As 可靠识别连接拒绝（ECONNREFUSED）、超时、主机不可达等关键网络错误，并避免依赖易变的错误字符串；同时说明如何系统性梳理标准库函数可能返回的错误类型。
本文详解如何使用 errors.is 和 errors.as 可靠识别连接拒绝（econnrefused）、超时、主机不可达等关键网络错误，并避免依赖易变的错误字符串；同时说明如何系统性梳理标准库函数可能返回的错误类型。
在 Go 网络编程中，简单地用 err.Error() == "connection refused" 判断错误类型是脆弱且不可移植的：错误消息随操作系统语言、Go 版本甚至底层 syscall 实现而变化（如葡萄牙语系统返回 "conexão recusada"），极易导致逻辑失效。现代 Go（1.13+）提供了结构化错误处理机制，推荐优先使用 errors.Is 与 errors.As 进行语义化判断。
✅ 推荐方式：使用 errors.Is 检测底层系统错误
对于 net.Dial、rpc.Dial 等函数抛出的连接类错误，最可靠的方式是匹配标准 syscall 错误码：
import (
"errors"
"net/rpc"
"syscall"
)
client, err := rpc.Dial("tcp", ":1234")
if err != nil {
if errors.Is(err, syscall.ECONNREFUSED) {
log.Println("服务未启动，尝试重连或降级处理")
// 例如：启动本地 mock 服务、返回缓存数据、触发告警
} else if errors.Is(err, syscall.ENETUNREACH) || errors.Is(err, syscall.EHOSTUNREACH) {
log.Println("网络不可达，请检查路由或防火墙")
} else if errors.Is(err, syscall.ECONNRESET) {
log.Println("连接被远端重置，可能是服务异常退出")
} else {
log.Printf("其他未知错误: %v", err)
}
return
}
⚠️ 注意：
syscall.ECONNREFUSED是 Linux/macOS 常见值；Windows 对应为syscall.WSAECONNREFUSED。但errors.Is自动适配平台——它会穿透多层错误包装（包括&net.OpError），准确比对底层原始错误，无需手动判断 OS。
✅ 进阶方式：用 errors.As 提取错误上下文
当需获取更丰富的错误信息（如失败操作名、地址、超时状态）时，应使用 errors.As 提取 net.OpError 或 net.DNSError：
var opErr *net.OpError
if errors.As(err, &opErr) {
log.Printf("网络操作失败: %s on %s (%s)",
opErr.Op, opErr.Net, opErr.Addr)
// 进一步判断是否为超时（推荐用 net.Error.Timeout()）
if nErr, ok := opErr.Err.(net.Error); ok && nErr.Timeout() {
log.Println("请求超时，考虑增加超时阈值或重试")
}
}
var dnsErr *net.DNSError
if errors.As(err, &dnsErr) {
log.Printf("DNS 解析失败: %s (isTimeout=%t, isTemporary=%t)",
dnsErr.Err, dnsErr.IsTimeout, dnsErr.IsTemporary)
}
? 如何获知一个标准库函数可能返回哪些错误？
官方文档（godoc）是第一手权威来源。例如 net.Dial 明确列出：
Errors returned by Dial depend on the underlying network and include common ones like
ErrNoNetwork,ErrNoRoute,ErrInvalidConnState,ErrClosed, andErrTimeout. It may also return*OpErrorwrapping platform-specific errors.
但最完整、最可靠的途径仍是阅读源码（如 src/net/dial.go 中 DialContext 的错误分支），尤其关注：
-
return &OpError{...}类型构造； -
return &DNSError{...}等具体错误实例； -
return os.NewSyscallError(...)→ 最终映射到syscall.Errno。
? 小技巧：在 VS Code / GoLand 中按住 Ctrl（或 Cmd）点击 Dial 跳转，快速定位错误生成逻辑。
? 关键注意事项总结
- ❌ 永远不要依赖
err.Error()字符串匹配——违反 Go 错误设计哲学，破坏可移植性； - ✅ 优先用
errors.Is(err, target)判断语义错误（如ECONNREFUSED,ETIMEDOUT）； - ✅ 用
errors.As(err, &T{})提取结构化错误详情，用于日志、监控或差异化处理； - ✅ 对
net.Error接口调用Timeout()/Temporary()方法，比解析字符串更安全； - ✅ 所有 HTTP 客户端响应（即使
resp.StatusCode >= 400）都必须resp.Body.Close()，否则连接池耗尽将导致后续请求“假超时”（详见http.Transport配置最佳实践）。
通过这套方法，你的错误处理逻辑将具备跨平台一致性、版本兼容性与长期可维护性，真正实现健壮的 Go 网络容错能力。
