本文介绍在 DNS 解析可能返回 AAAA 记录但本地无 IPv6 连通性时，避免硬编码错误判断、实现健壮网络连接的推荐方案——利用 Go 标准库的 net.Dialer 双栈机制与“快乐眼球（Happy Eyeballs）”策略自动降级。
本文介绍在 dns 解析可能返回 aaaa 记录但本地无 ipv6 连通性时，避免硬编码错误判断、实现健壮网络连接的推荐方案——利用 go 标准库的 `net.dialer` 双栈机制与“快乐眼球（happy eyeballs）”策略自动降级。
在构建高可用网络客户端时，一个常见却易被忽视的问题是：DNS 解析返回了 IPv6 地址（AAAA 记录），但运行环境实际不具备 IPv6 连通能力（如未配置默认路由、防火墙拦截或运营商不支持）。此时若对每个地址逐一 net.Dial 并手动捕获 EHOSTUNREACH 等底层系统错误（如原代码中通过反射解析 syscall.EHOSTUNREACH），不仅耦合度高、可移植性差，还违背 Go 的“让接口处理复杂性”设计哲学。
正确做法是交由标准库接管连接逻辑：使用 net.Dialer 并启用 DualStack: true，配合 net.Dial 直接传入主机名和端口（例如 "example.com:443"）。Go 从 1.15 起已原生支持 RFC 8305 定义的“Happy Eyeballs v2”算法——它会并行尝试 IPv6 和 IPv4 连接，并优先采用首个成功建立的连接；若 IPv6 因路由不可达、超时或拒绝连接而失败，则自动回退至 IPv4，全程无需业务代码感知地址族差异。
dialer := &net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
DualStack: true, // ✅ 启用双栈，触发 Happy Eyeballs
}
conn, err := dialer.Dial("tcp", "example.com:443")
if err != nil {
log.Fatalf("failed to connect: %v", err)
}
defer conn.Close()⚠️ 注意事项：
- 不要自行解析并轮询 IP 列表：手动调用 net.LookupHost 或 net.LookupIP 获取地址后逐个 Dial，会绕过 Happy Eyeballs 机制，导致 IPv6 失败时阻塞等待超时，显著拖慢连接速度；
- 避免依赖特定错误码：EHOSTUNREACH 在不同操作系统（Linux/macOS/Windows）或网络栈（如容器内 ipv6.disable=1）下表现不一致，且 Go 的错误包装层级可能随版本变化，硬解析 err.(*net.OpError).Err.(*os.SyscallError) 极易崩溃；
- DualStack: true 是关键开关：即使系统有 IPv6 协议栈但无全局路由，该设置仍能安全降级；若设为 false（默认值），则仅尝试 IPv4；
- 如需细粒度控制（如强制 IPv4-only），应显式使用 &net.IPAddr{IP: ip4} 构造地址，而非依赖运行时探测。
总结：真正的“proper way”不是修补失败的 IPv6 尝试，而是让连接层智能规避——通过 DualStack: true 委托 Go 运行时处理地址选择与故障转移。这既符合最小权限原则（业务逻辑专注协议交互，不操心网络拓扑），也保障了跨环境一致性与未来兼容性。
