登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go net.Resolver LookupIP 如何区分 DNS 临时错误

来源:17golang原创

时间:2026-11-17 16:05:53 493浏览 收藏

调用 net.Resolver.LookupIP 时,不要根据错误字符串里有没有 “timeout” 来决定是否重试。更稳妥的做法是先用 errors.As 提取 *net.DNSError,再读取 IsTimeout、IsTemporary 和 IsNotFound;如果错误来自上下文截止时间,还要用 errors.Is 判断 context.DeadlineExceeded。这样才能把临时 DNS 故障、超时、域名不存在和参数错误分开。

本文只讨论 resolver 的错误包装与地址结果,不展开 DNS 服务器配置。Go 官方文档中,LookupIP 的 network 必须是 ip、ip4 或 ip6,返回值是 IP 切片和错误。

LookupIP 的两个返回值要一起看

LookupIP 的签名是 LookupIP(ctx, network, host) ([]net.IP, error)。ip4 和 ip6 用于限定地址族,ip 则表示查询 IPv4 和 IPv6 地址。空主机名、未知网络类型等输入问题,也会在真正访问 DNS 前形成错误,所以不能把所有错误都当作临时网络抖动。

LookupIP 输入参数、地址结果和 DNSError 错误对象的静态关系说明图
图1:LookupIP 输入与返回对象的静态结构说明图,不是截图或运行证据。

第一步是保留原始 error,不要立刻用 fmt.Sprintf 变成字符串。错误值还可能包着更具体的 DNS 类型,过早格式化会丢掉后续分类需要的字段。

用 errors.As 取出 net.DNSError

DNS 查询错误通常可以通过 *net.DNSError 读取名称、DNS 服务器、错误描述和分类字段。使用 errors.As 能跨过包装层,比直接断言 err.(*net.DNSError) 更适合放在公共解析函数里。

package resolverdemo

import (
    "context"
    "errors"
    "net"
)

type lookupKind uint8

const (
    lookupOK lookupKind = iota
    lookupTimeout
    lookupTemporary
    lookupNotFound
    lookupPermanent
)

func classifyLookupError(err error) lookupKind {
    // nil 表示查询成功,先处理最常见的成功路径。
    if err == nil {
        return lookupOK
    }

    var dnsErr *net.DNSError
    if errors.As(err, &dnsErr) {
        // 域名不存在不是网络抖动,默认不应重复重试。
        if dnsErr.IsNotFound {
            return lookupNotFound
        }
        // 超时优先作为可退避的暂态故障处理。
        if dnsErr.IsTimeout || errors.Is(err, context.DeadlineExceeded) {
            return lookupTimeout
        }
        // IsTemporary 是 DNS 错误对象提供的更具体信号。
        if dnsErr.IsTemporary {
            return lookupTemporary
        }
        return lookupPermanent
    }

    var netErr net.Error
    if errors.As(err, &netErr) && netErr.Timeout() {
        // 非 DNSError 也可能是被包装的网络超时。
        return lookupTimeout
    }
    if errors.Is(err, context.DeadlineExceeded) {
        // 截止时间错误可能经过多层包装,使用 errors.Is 判断。
        return lookupTimeout
    }
    return lookupPermanent
}

这里特意把 IsNotFound 放在前面:域名不存在时,即使底层错误描述看起来像一次失败,也没有继续向同一个目标重试的价值。反过来,超时和明确标记为临时的 DNS 错误,才适合进入有限次数的退避流程。

三个字段分别代表什么

IsTimeout 表示 DNS 错误已知是超时,但官方文档也提醒,并不是所有超时都能被可靠标记。IsTemporary 表示错误已知是暂时性的,同样可能因为底层信息不足而为 false。IsNotFound 表示名称不存在或没有请求类型的记录,通常对应 NXDOMAIN 或没有数据。

因此,字段为 false 不等于“永远不会恢复”,它只说明这次错误没有被 Go 标成该类别。业务重试还应受总截止时间、次数上限和退避间隔约束。另一个容易混淆的点是 net.Error.Temporary():当前 Go 文档已注明该方法语义不明确并建议不要使用,新的分类逻辑应优先读取 DNSError 字段和 Timeout()。

DNSError 字段、errors.As 和重试降级策略之间的静态关系说明图
图2:DNS 错误字段与调用策略的关系说明图,不是截图或运行证据。

把 context 截止时间纳入判断

resolver 调用应该接收调用方的上下文,而不是在底层偷偷创建一个无限期的 context.Background()。这样上层才能把 DNS 查询纳入请求总预算。使用 context.WithTimeout 时,超时后可以通过 errors.Is 判断截止时间语义。

func lookupWithDeadline(parent context.Context, host string) ([]net.IP, lookupKind, error) {
    ctx, cancel := context.WithTimeout(parent, 2*time.Second)
    defer cancel() // 释放计时器资源,避免成功返回后仍保留定时器。

    ips, err := (&net.Resolver{}).LookupIP(ctx, "ip", host)
    if err != nil {
        // 先分类,再把原始错误交给上层记录或包装。
        return nil, classifyLookupError(err), err
    }
    return ips, lookupOK, nil
}

上面的示例还需要在导入区加入 time。如果父上下文已经取消,分类函数应把它视为调用方主动放弃,而不是无限重试的 DNS 临时故障;实际项目可以额外定义 lookupCanceled,把 context.Canceled 单独记录。

只对暂态故障做有限重试

重试决策应建立在分类结果上,而不是建立在字符串匹配上。超时或明确的临时错误可以采用指数退避;找不到主机、未知网络类型和格式错误应直接返回;调用方取消则立即结束。重试期间仍要检查父上下文,避免 DNS 已经恢复但请求预算已经耗尽。

func shouldRetry(kind lookupKind, attempt int) bool {
    // 次数上限是保护条件,防止 DNS 故障放大为请求风暴。
    if attempt >= 3 {
        return false
    }
    switch kind {
    case lookupTimeout, lookupTemporary:
        return true
    default:
        // not found、永久错误和成功都不走重试分支。
        return false
    }
}

如果业务允许降级,可以在 lookupNotFound 或 lookupPermanent 分支返回缓存地址、备用域名或明确的用户错误,但不要把降级结果伪装成 DNS 查询成功。

StrictErrors 不是错误分类器

Resolver.StrictErrors 控制 Go 内置 resolver 在由多个子查询组成的请求中遇到临时错误时,是否让整个查询失败。它影响查询结果的组合方式,不会替代 DNSError 的字段判断,也不能把所有错误都变成“可重试”。如果你只需要 IPv4 或 IPv6,应在调用时明确传入 ip4 或 ip6,减少不必要的地址族歧义。

速查:什么情况应该重试

信号常见处理原因
IsTimeout 为 true有限次数退避重试查询在时间预算内未完成
IsTemporary 为 true有限次数退避重试Go 已识别为暂态 DNS 故障
IsNotFound 为 true直接返回或业务降级目标名称或记录不存在
UnknownNetworkError修正调用参数network 不在允许集合中
context.Canceled立即结束调用方已取消请求

一句话总结:先用 errors.As 找到 *net.DNSError,再按 IsNotFound、IsTimeout、IsTemporary 和上下文错误分流;重试只覆盖有明确暂态信号的分支,并受次数与截止时间共同约束。

相关问题

  • 为什么不能直接匹配 “no such host”? 因为错误文本是展示信息,不是稳定的程序接口;应读取类型和字段。
  • LookupIP 的 network 传空字符串可以吗? 不可以,官方接口要求使用 ip、ip4 或 ip6。
  • Temporary() 为 false 就一定不能重试吗? 不一定,但它说明 Go 没有确认临时性;应结合超时、上下文、业务总预算和备用路径决定。
  • 为什么要把原始 error 返回给上层? 上层可能需要记录 DNS 名称、服务器、取消原因或用 errors.Is 做进一步分流。

参考资料:Go net.Resolver.LookupIP、Go net.DNSError、Go 标准库 lookup.go。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>