Go net.Resolver调整 IPv4 与 IPv6 地址选择的兼容边界

Go 的 net.Resolver 没有一个名为“优先 IPv4”或“优先 IPv6”的字段。要调整地址族选择，应该把策略拆成两段：解析阶段用 LookupIP 明确查询 ip4 或 ip6，连接阶段再用 tcp4 或 tcp6 固定传输族。这样即使系统 DNS、AAAA 记录或操作系统默认顺序发生变化，业务也不会把“返回顺序”误当成稳定契约。

官方文档：https://pkg.go.dev/net

先把 Resolver 的三个边界分开

Resolver.PreferGo 只影响是否优先使用 Go 自带的 DNS 解析器；Resolver.Dial 是给该解析器连接 DNS 服务的替代拨号函数，都不是地址族排序开关。StrictErrors 则控制多子查询中临时错误的处理方式。它在 A 与 AAAA 组合查询时设为 true，可能让一个临时的 AAAA 错误拖累整个结果，因此兼容老旧或不完整 DNS 环境时通常保持默认的 false，除非业务必须要求双查询全部成功。

如果只是要观察两种地址，不要依赖 LookupIPAddr 返回切片的先后顺序；官方接口只保证它返回 IPv4 和 IPv6 地址。要表达策略，就在自己的代码中保存“首选族”和“回退族”。

用 ip4 和 ip6 实现明确的首选与回退

下面的函数把“首选 IPv6，失败后尝试 IPv4”写成可读的策略。它没有把 DNS 返回顺序当成偏好，也没有在首选查询报错时丢失原始错误。

package main

import (
    "context"
    "fmt"
    "net"
)

// lookupPreferred 先查指定地址族，查不到结果时再查备用地址族。
func lookupPreferred(ctx context.Context, r *net.Resolver, host string, preferIPv6 bool) ([]net.IP, error) {
    first, second := "ip6", "ip4"
    if !preferIPv6 {
        // 业务明确偏好 IPv4 时交换查询顺序。
        first, second = "ip4", "ip6"
    }

    ips, firstErr := r.LookupIP(ctx, first, host)
    if firstErr == nil && len(ips) > 0 {
        return ips, nil
    }

    // 首选族无结果后才回退，保留两次查询的上下文。
    fallback, secondErr := r.LookupIP(ctx, second, host)
    if secondErr != nil {
        return nil, fmt.Errorf("lookup %s failed: %v; fallback %s failed: %w", first, firstErr, second, secondErr)
    }
    return fallback, nil
}

这里的“首选”是应用层的查询顺序，不代表 DNS 服务器会改变记录。若首选族返回了地址但后续连接失败，可以把每个地址逐个交给连接策略，而不是立刻把 DNS 失败和 TCP 失败混为一谈。

连接阶段用 tcp4 或 tcp6 固定传输族

解析结果只是候选地址，真正建立 TCP 连接时仍要再次表达地址族。net.Dialer.DialContext 的网络参数使用 tcp4 或 tcp6，可以避免解析阶段选了 IPv6、连接阶段却又回到不明确的 tcp。

// dialFamily 让解析和连接使用同一地址族策略。
func dialFamily(ctx context.Context, r *net.Resolver, host, port, network string) (net.Conn, error) {
    if network != "tcp4" && network != "tcp6" {
        return nil, fmt.Errorf("unsupported network %q", network)
    }

    d := net.Dialer{
        Resolver: r,
    }
    // JoinHostPort 能正确处理 IPv6 地址的方括号格式。
    return d.DialContext(ctx, network, net.JoinHostPort(host, port))
}

如果采用“IPv6 优先、IPv4 兜底”，可以先用 tcp6 尝试，再在同一个尚未过期的 context 中用 tcp4。每次尝试都要记录网络参数和底层错误；否则日志只剩一个笼统的“连接失败”，很难判断是 AAAA 不可达、IPv6 路由缺失，还是服务端端口本身没有监听。

兼容性判断清单

生产环境还要区分“首选族没有记录”和“首选族有记录但连接失败”。前者可以安全地触发 DNS 级回退，后者则要结合超时、路由和服务端监听状态判断，避免把网络故障掩盖成解析成功。

常见问题

把 Resolver.PreferGo 设为 true 就会优先 IPv4 吗？

不会。它只改变 DNS 解析器实现的选择范围，地址族仍应通过 LookupIP 或拨号网络参数表达。

LookupIPAddr 返回 IPv6 在前，能直接当成 IPv6 优先吗？

不建议。应由应用保存明确的首选族和回退规则，必要时分别查询 ip6 与 ip4。

什么时候应该打开 StrictErrors？

只有当业务不能接受部分地址结果，并且已经确认 DNS 环境能稳定处理 A 与 AAAA 组合查询时才考虑打开；兼容优先时保持默认值更稳妥。