Go net.Resolver LookupIP 如何区分 DNS 临时错误
调用 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 前形成错误,所以不能把所有错误都当作临时网络抖动。

第一步是保留原始 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()。

把 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。
Go url.Values.Has 怎样判断查询参数是否出现
- 上一篇
- Go url.Values.Has 怎样判断查询参数是否出现
- 下一篇
- Go debug/macho.Segment.Data 怎样读取 Mach-O 段的原始内容
-
- Golang · Go问答 | 12分钟前 | go · Go 调试信息 debug/dwarf DWARF Data.AddSection
- Go debug/dwarf.Data.AddSection 怎样补充 DWARF 节数据
- 346浏览 收藏
-
- Golang · Go问答 | 17分钟前 | 标准库 · Go问答 · Go 二进制文件 Mach-O debug/macho Segment.Data 原始字节
- Go debug/macho.Segment.Data 怎样读取 Mach-O 段的原始内容
- 475浏览 收藏
-
- Golang · Go问答 | 27分钟前 |
- Go url.Values.Has 怎样判断查询参数是否出现
- 368浏览 收藏
-
- Golang · Go问答 | 35分钟前 |
- Go math/big.Int.AppendText 怎样把大整数追加成文本
- 106浏览 收藏
-
- Golang · Go问答 | 47分钟前 | 标准库 · Go问答 · Go net/mail Header.Get 邮件头 首个值
- Go net/mail.Header.Get 怎样读取邮件头的首个值
- 135浏览 收藏
-
- Golang · Go问答 | 49分钟前 |
- Go context.WithCancel 取消后子 goroutine 为什么仍不退出
- 283浏览 收藏
-
- Golang · Go问答 | 53分钟前 | 标准库 · csv · Go问答 · Go encoding/csv CSV注释行 csv.Reader.Comment TrimLeadingSpace
- Go csv.Reader.Comment 为什么会跳过某些以井号开头的记录
- 104浏览 收藏
-
- Golang · Go问答 | 55分钟前 | 标准库 · 错误处理 · csv · Go问答 · Go error FLUSH encoding/csv csv.Writer CSV分隔符 Writer.Comma
- Go csv.Writer.Comma 不是逗号时怎样设置合法分隔符
- 457浏览 收藏
-
- Golang · Go问答 | 1小时前 | 网络编程 · 标准库 · ip地址 · Go问答 · Go ip地址 netip.Addr MarshalText encoding.TextMarshaler
- Go netip.Addr.MarshalText 怎样编码 IP 地址文本
- 163浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · go · Go 命名类型 DWARF TypedefType
- Go dwarf.TypedefType 怎样保留命名类型的名称与引用
- 486浏览 收藏
-
- Golang · Go问答 | 1小时前 | bufio · Go问答 · Go eof io.Reader bufio.Reader.Discard ErrNegativeCount
- Go bufio.Reader.Discard 返回值为什么可能小于请求长度
- 315浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · xml · Go问答 · Go encoding/xml Decoder.Token ProcInst XML处理指令
- Go encoding/xml.ProcInst 怎样读取 XML 处理指令内容
- 295浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1075次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1076次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1238次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1181次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1023次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- 深入了解Golang网络编程Net包的使用
- 2023-01-23 215浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览

