net.LookupIP是最直接获取域名全部IPv4/IPv6地址的方式,返回[]net.IP切片,默认查A和AAAA记录;需用ip.To4()!=nil安全判IPv4,显式加context.WithTimeout防阻塞,并注意错误类型为*net.DNSError。

用 net.LookupIP 获取域名全部 IPv4 和 IPv6 地址
net.LookupIP 是 Go 标准库中获取域名解析结果最直接的方式。它返回一个 []net.IP 切片,包含该域名所有已解析的 IP 地址(默认同时查 A 和 AAAA 记录),无需手动区分协议版本。
常见错误是只取第一个结果(ips[0]),但 DNS 轮询、CDN 或多机房部署下,返回顺序不固定,且可能含 IPv6 地址——若下游服务仅支持 IPv4,直接用会连不上。
- 调用前确保 DNS 配置正常,
net.DefaultResolver依赖系统/etc/resolv.conf;如需自定义 DNS 服务器,应显式设置net.Resolver - 返回的
net.IP是原始字节切片,打印时用ip.String()更可读 - 超时控制必须显式加:标准库默认无超时,阻塞风险高;推荐用
context.WithTimeout包裹
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel() ips, err := net.DefaultResolver.LookupIP(ctx, "ip4", "google.com") // 只查 IPv4 // 或用 "ip6" 查 IPv6,"ip" 查全部
区分 IPv4/IPv6 并过滤无效地址
实际使用中常需分离协议类型,或剔除本地回环、私有网段等不可达地址。Go 的 net.IP 提供了 IsLoopback()、IsPrivate()、To4() 等方法,但要注意:To4() 对 IPv6 地址返回 nil,不是报错,容易被忽略。
-
ip.To4() != nil是判断 IPv4 的安全方式,比ip.To16() != nil更可靠(因 IPv4 映射地址在 Go 中也返回 16 字节) -
net.ParseIP("::1").IsLoopback()返回true,但net.ParseIP("127.0.0.1").IsLoopback()同样为true,需结合业务场景决定是否过滤 - 某些 CDN 域名(如 Cloudflare)返回的 IP 可能是任播地址,
IsGlobalUnicast()不适用,得靠业务层探测可用性
处理 LookupIP 常见错误和超时
错误类型集中在 *net.DNSError,其 Err 字段才是真实原因,比如 "no such host" 或 "server misbehaving"。直接打印 err.Error() 容易漏掉关键上下文。
- 检查
err.(*net.DNSError).IsNotFound可区分「域名不存在」和「网络不通」 - 超时错误通常表现为
context.DeadlineExceeded,不是net.OpError,别用errors.Is(err, syscall.ETIMEDOUT)判断 - DNSSEC 验证失败不会单独报错,而是返回空结果 +
Err为"dns: bad rdata"类似字符串,需正则匹配或用第三方库(如miekg/dns)深挖
需要精确控制查询类型时改用 net.LookupAAAA 和 net.LookupCNAME
如果只要 IPv6 地址,net.LookupIP(ctx, "ip6", domain) 比 net.LookupAAAA 更简洁;但后者能明确排除 CNAME 展开逻辑(LookupIP 默认跟随 CNAME)。某些场景下,你希望拿到原始 CNAME 记录用于调试或合规审计。
-
net.LookupCNAME返回的是规范域名,不是 IP,但它能帮你确认是否被 CDN 或负载均衡器重写 -
net.LookupTXT和net.LookupSRV无法通过LookupIP替代,它们返回结构化数据,类型完全不同 - 并发查多个记录时,避免复用同一个
context.Context:一个子任务超时不应杀死其他查询,建议每个查新起独立WithTimeout
Go 的 DNS 解析看似简单,但 net.IP 的零值隐式转换、CNAME 自动跟随、以及不同平台对 /etc/resolv.conf 的解析差异(比如 macOS 的 mDNS),会让线上行为和本地开发不一致。真正上线前,务必在目标环境跑一次完整解析链路。











