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 前形成错误,所以不能把所有错误都当作临时网络抖动。

第一步是保留原始 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。
-
346 收藏
-
475 收藏
-
368 收藏
-
106 收藏
-
135 收藏
-
283 收藏
-
Golang · Go问答 | 52分钟前 | 标准库 · csv · Go问答 · Go encoding/csv CSV注释行 csv.Reader.Comment TrimLeadingSpace104 收藏
-
Golang · Go问答 | 54分钟前 | 标准库 · 错误处理 · csv · Go问答 · Go error FLUSH encoding/csv csv.Writer CSV分隔符 Writer.Comma457 收藏
-
Golang · Go问答 | 1小时前 | 网络编程 · 标准库 · ip地址 · Go问答 · Go ip地址 netip.Addr MarshalText encoding.TextMarshaler163 收藏
-
486 收藏
-
315 收藏
-
295 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习