Go net.Resolver 如何为单次查询指定 DNS 服务器

需要让某一次域名查询走指定 DNS，而不改机器的 /etc/resolv.conf，可以给这次调用单独创建一个 net.Resolver，设置 PreferGo: true，再通过 Dial 把 DNS 连接指向目标 IP。关键是：Dial 的地址参数是 DNS 服务端地址，必须是字面量 IP 和端口；真正要解析的域名仍然传给 LookupHost。

官方资料：https://pkg.go.dev/net#Resolver

先分清 Resolver.Dial 的作用范围

net.Resolver 有 Go 内置 resolver 和系统原生 resolver 两条路径。Dial 是给 Go 内置 DNS resolver 建立 UDP/TCP 连接的钩子；如果代码仍走 cgo 或系统解析路径，自定义拨号器就不会按预期接管。因此单次定向查询通常把 PreferGo 设为 true，并调用这个 Resolver 的方法，而不是调用包级函数。

为本次查询绑定 DNS IP

下面的例子把 DNS 服务固定为示例网段中的 192.0.2.53:53。该地址仅用于文档示意，实际部署时替换成你所在网络中可达且获授权使用的 DNS 服务器 IP。回调收到的 address 由解析器传入，代码不需要自行解析它，但应保留 network，让解析器在需要时选择 UDP 或 TCP。

package main

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

func lookupOnce(ctx context.Context, host string) ([]string, error) {
    resolver := &net.Resolver{
        PreferGo: true, // 让本次查询优先使用可调用 Dial 的 Go resolver
        Dial: func(dialCtx context.Context, network, _ string) (net.Conn, error) {
            if network != "udp" && network != "tcp" {
                return nil, fmt.Errorf("unsupported DNS network: %s", network) // 拒绝未预期的传输类型
            }
            dialer := net.Dialer{Timeout: 2 * time.Second}
            return dialer.DialContext(dialCtx, network, "192.0.2.53:53") // 只连接指定的字面量 DNS 地址
        },
    }
    return resolver.LookupHost(ctx, host) // host 是要解析的业务域名，不是 DNS 服务器地址
}

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
    defer cancel() // 无论成功或失败都释放本次查询的取消函数

    addrs, err := lookupOnce(ctx, "example.com")
    if err != nil {
        fmt.Println("DNS lookup failed:", err) // 保留 DNSError 等原始上下文供排查
        return
    }
    fmt.Println(addrs)
}

这里的生命周期是“创建 Resolver—发起一次查询—结束”。如果业务要为不同请求选择不同 DNS，建议按请求配置或按 DNS 地址做受控缓存，不要在多个 goroutine 共用时动态改写同一个 Resolver.Dial 字段。

调用带上下文的解析方法

LookupHost 返回目标主机的地址字符串；需要明确 IPv4 或 IPv6 时，可以改用 LookupNetIP(ctx, "ip4", host) 或 LookupNetIP(ctx, "ip6", host)。这两种方法都属于该 Resolver，因而会沿用上面的 DNS 连接策略。context 被取消时，底层拨号和查询应尽快返回；超时时不要把空结果当成成功。

处理 UDP、TCP 和失败边界

官方文档规定，Resolver.Dial 收到的 DNS 服务地址应是字面量 IP 和端口。回调返回 net.PacketConn 时，DNS 消息要符合 UDP 的报文约束；返回普通连接时则遵循 DNS over TCP 的连接约束。实际代码应尽量原样使用 network，不要为了“固定 DNS”顺手把所有请求强行改成一种传输。

如果结果是 server misbehaving、SERVFAIL 或上下文超时，先判断是目标 DNS 不可达、请求被取消，还是服务端确实没有给出可用答案。指定 DNS 只改变“问谁”，不保证该服务器拥有目标域名的权威记录，也不会绕过网络策略或 DNS 分流。

常见问题

为什么设置了 Dial，查询仍然走系统 DNS？

最常见原因是调用了包级 net.LookupHost，或当前平台没有按预期使用 Go 内置 resolver。把查询改成自定义 Resolver 的方法，并检查 PreferGo 与运行环境。

Dial 回调里的 address 能直接改成域名吗？

不建议。标准库约定这里是字面量 DNS IP 和端口；写域名会再次触发解析，可能形成递归或让“指定 DNS”失去意义。

能不能把 Resolver 做成全局变量？

可以复用一个配置不变的 Resolver，但不要并发修改它的字段。若 DNS 服务器、超时策略随请求变化，更稳妥的做法是创建独立实例或按配置构造只读缓存。