Go 自定义 Resolver Dial 时怎么保留请求的网络环境

给 Go HTTP 客户端换自定义 DNS 时，最容易漏掉的不是 DNS 地址，而是请求上下文。可靠的做法是让 net.Resolver.Dial 只负责 DNS 传输，并把它收到的 ctx、network、address 原样交给同一个 net.Dialer.DialContext；再把这个 net.Dialer 交给 http.Transport.DialContext。这样请求的取消、截止时间、LocalAddr 和 Control 等网络配置不会在自定义回调里丢失。

一句话判断：不要在 Resolver.Dial 里调用不带上下文的 net.Dial，也不要把回调参数改成固定的 UDP 或固定 DNS 地址；转发参数，才是保留请求网络环境的最小正确实现。

Resolver.Dial 到 DNS 连接的边界

Resolver.Dial 不是 HTTP 请求的拨号钩子。它是 Go 内置解析器连接 DNS 服务时使用的回调；回调里的 network 可能是 UDP 或 TCP 变体，address 的主机部分应是 DNS 服务器的字面量 IP，端口也是字面量端口。Go 源码在没有自定义回调时会使用一个零值 net.Dialer 调用 DialContext，自定义回调也应保持这个契约。

因此，直接写成 net.Dial("udp", "10.0.0.53:53") 有两个问题：它丢弃了解析器传入的截止时间和取消信号，还可能破坏解析器在 TCP/UDP 之间的选择。若运行环境要求走纯 Go 解析器，还要显式设置 PreferGo；否则在某些系统条件下可能走系统解析器，自定义 Dial 不会覆盖那条路径。

用 DialContext 转发三项关键参数

下面的配置把 DNS 解析与网络策略放到同一个 net.Dialer 上。注意这里没有自行拼接地址，也没有把 ctx 换成 context.Background()：

resolver := &net.Resolver{
	PreferGo: true, // 让本 Resolver 优先使用 Go 内置解析器
}

dialer := &net.Dialer{
	Timeout:   5 * time.Second, // 同时约束 DNS 连接和目标连接的拨号阶段
	LocalAddr: localAddr,       // 有专网出口时保留本地绑定地址
	Control:   control,         // 需要设置 socket 时沿用同一网络策略
}

resolver.Dial = func(ctx context.Context, network, address string) (net.Conn, error) {
	// ctx 负责请求取消和截止时间，network/address 由 Resolver 决定
	return dialer.DialContext(ctx, network, address)
}

// HTTP 目标连接也使用这个 Resolver 和 Dialer，形成一条一致的配置链
dialer.Resolver = resolver
transport := &http.Transport{
	DialContext: dialer.DialContext, // 仍保留每个请求传入的 ctx
}
client := &http.Client{Transport: transport}

这里的自引用是安全的：Resolver.Dial 收到的 DNS address 是字面量 IP，不需要再次解析主机名，所以不会因为 dialer.Resolver = resolver 形成递归 DNS。HTTP 请求用 http.NewRequestWithContext 创建后，Transport.DialContext 会把请求上下文带入目标连接；目标域名的解析阶段也就能沿着同一条取消链路结束。

把 DNS 配置和 HTTP 目标连接分开核对

实际排查时，先问清楚失败发生在哪个边界。DNS 服务器连不上，应检查 Resolver.Dial 收到的 network 与 address、本地绑定和出口策略；目标服务连不上，则检查 Transport.DialContext 返回的目标连接、代理配置和 TLS。两者都用同一个 net.Dialer，不代表它们是同一条连接。

超时、取消和本地网络配置的兼容边界

net.Dialer.Timeout 是拨号器自身的上限，不能替代请求上下文；两者同时存在时，应以更早到达的截止时间为准。请求取消后，回调应尽快返回 ctx.Err() 对应的错误。若 Control 修改 socket 选项，记得 DNS 连接和目标连接都会经过同一个拨号器，必要时在回调中按 network 或地址边界区分策略。

如果只想为某个独立查询使用自定义解析器，可以直接调用 resolver.LookupIPAddr(ctx, host)；如果希望 HTTP 请求自动使用它，就必须把解析器挂到实际负责目标连接的 net.Dialer，并将该拨号器的 DialContext 交给 Transport。测试时至少覆盖：DNS 连接超时、请求提前取消、IPv4/IPv6 返回、多请求并发复用和本地地址绑定。

常见问题

Resolver.Dial 里的 address 可以写域名吗？

不建议也不应依赖这种写法。Go 文档约定这里是 DNS 服务的字面量 IP 和端口，否则可能再次触发解析。

为什么设置了 Dial 但回调没有被调用？

通常是当前平台选择了系统解析器。需要评估兼容性后设置 PreferGo: true，再确认查询确实走这个 Resolver。

context.Background 会让请求继续跑吗？

会。它切断了请求的取消链路；Resolver.Dial 和 Transport.DialContext 都应接收并继续传递调用方的上下文。

参考资料

• Go net.Resolver 文档：Resolver.Dial、PreferGo 与地址约定。
• Go net/lookup.go：解析器如何调用自定义 Dial。
• Go net/http.Transport 文档：DialContext 与请求连接边界。
• Go context 文档：截止时间和取消信号的传播语义。