必须显式构造net.Resolver并设PreferGo:true,否则Dial回调不生效;http.Client需通过Transport.DialContext手动调用该resolver,且域名须为FQDN,IPv4查询应指定"ip4"参数以避免连接失败。

Go 里没有“DNS 自动化管理”这种开箱即用的模块——所有所谓自动化,本质是组合 net.Resolver、http.Transport.DialContext、缓存逻辑和健康探测,手动控制解析时机与结果生命周期。
先说说最让人头疼的部分:如何让 Go 程序用上你指定的 DNS 服务器(比如 1.1.1.1),而不是系统默认的。这里的关键是必须显式构造 net.Resolver 并设置 PreferGo: true,否则 Dial 回调根本不会生效。系统 resolver(比如 glibc 的 getaddrinfo)会完全绕过你的配置,你辛辛苦苦写的回调就成了摆设。
PreferGo: true是强制开关,不是可选项;不设它,Dial函数根本不会被调用Dial必须返回net.Conn,且协议只能是"udp"或"tcp",端口固定为53- 别传字符串地址(如
"udp://1.1.1.1:53"),Dial是函数,不是 URL 解析器 - 超时必须由
context.Context控制,硬写net.Dial("udp", ...)会阻塞协程无法中断
一个典型的示例写法:
resolver := &net.Resolver{ PreferGo: true, Dial: func(ctx context.Context, network, addr string) (net.Conn, error) { return net.Dialer{Timeout: 3 * time.Second}.DialContext(ctx, "udp", "1.1.1.1:53") },}为什么 http.Client 还是走系统 DNS,即使设置了自定义 Resolver?
这个问题坑了不少人。http.Client 完全不认 net.Resolver,它只看 http.Transport.DialContext。你必须在 DialContext 里手动调用你的 resolver,否则 TLS 握手、HTTP/2 连接复用等环节仍然会走系统默认的 DNS。
- 只改
http.Transport.Dial(旧签名)根本没用,它不参与 TLS 连接建立 - 必须用
DialContext,并在其中调用resolver.LookupHost(ctx, host)或resolver.LookupIP(ctx, "ip", host) - 如果后端启用了 SNI(绝大多数 HTTPS 服务),记得把原始域名赋给
TLSConfig.ServerName,否则证书校验会失败 - HTTP 连接复用时,
Transport默认会缓存 DNS 结果(TTL=0),需要配合自定义 resolver 的缓存逻辑或设置Transport.IdleConnTimeout
解析 Headless Service 时为什么只拿到一个 IP 或报 no such host?
Kubernetes Headless Service 不生成聚合 A 记录,而是为每个 Pod 返回独立 A/AAAA 记录——但 Go 默认的 LookupHost 会做去重+随机选一个,LookupIP 才返回全量 IP 列表。
- 必须用
resolver.LookupIP(ctx, "ip", "my-svc.default.svc.cluster.local"),不能用LookupHost - 域名必须是完整 FQDN(带
.svc.cluster.local),Go 的纯 Go resolver 不读/etc/resolv.conf的search域,不会自动补全 - 返回的
[]net.IP顺序不保证,Kubernetes DNS 不排序,Go 也不保证;不要假设第一个就是主节点 - 每次请求前应重新查 DNS(带合理 TTL 缓存,如 30s),再对每个 IP 做轻量 TCP 探活(
net.DialTimeout("tcp", ip+":port", 500*time.Millisecond)),跳过不可达节点
如何避免 LookupIP 返回 IPv6 地址导致连接失败?
LookupIP 默认返回所有记录(v4+v6),而目标服务可能只监听 IPv4。直接遍历连接容易因 IPv6 路由不通而卡住。
- 用
resolver.LookupIP(ctx, "ip4", host)显式限定只查 IPv4,这比事后过滤更高效 - 若服务支持双栈,但网络环境 IPv6 不稳定,建议先查
"ip4",失败后再 fallback 到"ip6" - 注意:某些 DNS 服务器(如 Cloudflare 1.1.1.1)对
"ip4"查询会返回空,实际需查"ip"再手动过滤ip.To4() != nil - 别依赖
net.ParseIP判断类型——它对 IPv4-mapped IPv6 地址(如::ffff:192.0.2.1)返回nil,要用ip.To4()或ip.To16()明确判别
真正难的不是查到 IP,而是决定什么时候查、查几次、查完怎么用——这些逻辑没法交给标准库,得自己扛。