当前位置:首页 > 文章列表 > Golang > Go问答 > Go net.Resolver LookupIP 如何区分 DNS 临时错误

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

来源:17golang原创 2026-11-17 16:05:53 0浏览 收藏

调用 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删除
Go url.Values.Has 怎样判断查询参数是否出现Go url.Values.Has 怎样判断查询参数是否出现
上一篇
Go url.Values.Has 怎样判断查询参数是否出现
Go debug/macho.Segment.Data 怎样读取 Mach-O 段的原始内容
下一篇
Go debug/macho.Segment.Data 怎样读取 Mach-O 段的原始内容
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1075次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1076次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1238次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1181次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1023次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码