Go net.Resolver为解析器设置独立超时的配置方法

Go 中想给 DNS 解析单独设超时，不能只给 net.Resolver 填一个整数参数。更稳妥的做法是分两层配置：调用 LookupHost 时用一个独立的 context.WithTimeout 限制整次解析；如果还要限制解析器连接 DNS 服务器的时间，就在 Resolver.Dial 中使用 net.Dialer.DialContext。这样业务请求可以有自己的截止时间，DNS 又不会无限占用请求资源。

先把两个超时边界分开

解析慢通常有两种表现：一是从开始查找到返回结果的总时间太长；二是解析器连接 DNS 服务端时某一次 UDP 或 TCP 尝试迟迟没有结束。前者应该由传给 LookupHost 的 context 负责，后者可以在 Resolver.Dial 中交给一个带超时的 net.Dialer。

这两个时间不应简单相加后当作“精确耗时”。一次查找可能包含多个地址族、搜索域或重试，解析总时限是最终边界，Dial 超时则是单次传输尝试的边界。

用 Resolver.Dial 给 DNS 连接设独立上限

下面的 resolver 强制优先使用 Go 内置解析器，并把 DNS 传输连接的上限设为 800 毫秒。回调必须使用传入的 context；如果上游解析已经被取消，底层 Dialer 也要尽快停止。

package main

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

func lookupWithTimeout(parent context.Context, host string) ([]string, error) {
    // Dialer 的 Timeout 约束单次连接 DNS 服务器的等待时间。
    dialer := &net.Dialer{Timeout: 800 * time.Millisecond}
    resolver := &net.Resolver{
        PreferGo: true,
        Dial: func(ctx context.Context, network, address string) (net.Conn, error) {
            // 必须继承 resolver 传入的 ctx，保留取消和截止时间语义。
            return dialer.DialContext(ctx, network, address)
        },
    }

    // 这是整次 LookupHost 的总时限，不能省略 cancel。
    lookupCtx, cancel := context.WithTimeout(parent, 2*time.Second)
    defer cancel()

    addresses, err := resolver.LookupHost(lookupCtx, host)
    if err != nil {
        // 先判断 context，再保留原始错误供日志和重试策略使用。
        if errors.Is(err, context.DeadlineExceeded) {
            return nil, fmt.Errorf("DNS lookup deadline exceeded: %w", err)
        }
        return nil, fmt.Errorf("DNS lookup failed: %w", err)
    }
    return addresses, nil
}

这里的 parent 可以来自 HTTP 请求、任务上下文或服务级上下文。WithTimeout 让解析拥有明确的 2 秒总预算，而 Dialer.Timeout 只负责单次 DNS 连接。两者同时存在时，先到期的限制生效。

为什么要显式保留调用方 context

如果直接使用 context.Background() 创建解析上下文，业务请求即使已经断开，DNS 仍可能继续消耗 goroutine 和网络资源。生产代码应从调用方传入的 context 派生超时；当请求取消时，解析总时限与底层 Dial 都会收到取消信号。

还要注意，Resolver.Dial 是 Go 内置 DNS resolver 的自定义连接入口，不是全局 DNS 配置，也不是对已经建立的连接做读写超时。需要控制读取结果的上限时，仍应依赖解析调用 context，并在更上层设置请求截止时间。

PreferGo 和错误判断的几个边界

PreferGo: true 表示在支持的环境中优先使用 Go 自带解析器。自定义 Dial 只对这条解析路径有意义；如果代码依赖系统 cgo resolver 的行为，就不要把它当作通用的系统级超时开关。

错误处理建议保留原始错误。可用 errors.Is 判断调用方 context 是否超时或取消，再结合 net.DNSError.Timeout() 判断 DNS 错误是否被标记为超时。不要只比较错误字符串，也不要把一次 DNS 超时直接解释成域名不存在。

常见问题

Resolver.Dial 的 Timeout 能限制整次 LookupHost 吗？

不能。它限制的是自定义 Dialer 的单次连接等待；整次查找应使用传给 LookupHost 的 context。

一定要设置 PreferGo 吗？

如果依赖 Resolver.Dial 自定义 DNS 连接，通常应明确设置并结合目标平台测试；它只是解析器选择倾向，不会改变系统的 resolv.conf。

解析超时后还能继续使用 resolver 吗？

可以。Resolver 可被并发使用，超时的是本次调用；下一次调用仍应传入新的、有效的 context。

实际配置时，先给 LookupHost 一个符合业务预算的总时限，再把 Dial 单次连接设得更短，并保留 parent context 的取消链路。这样更容易区分“业务预算耗尽”和“DNS 传输迟迟未连通”两类问题。