Go DNS LookupIP 和 LookupHost 返回结果为什么不同

我排查 DNS 问题时，最容易误判的一幕是：同一个域名调用 LookupHost 和 Resolver.LookupIP，打印出来的地址数量、顺序甚至地址族都不一样。通常不是 Go 把同一条记录“解析错了”，而是两个 API 的输入契约不同：LookupHost 返回地址字符串，不让调用方指定地址族；LookupIP 必须传入 ip、ip4 或 ip6，并返回 []net.IP。

要比较两个结果，先确认 network 参数和地址族，再确认返回值类型，最后才去查本机 resolver。需要双栈连接时用 ip，只连 IPv4 或 IPv6 时显式用 ip4 或 ip6，不要拿一次查询的顺序当成稳定协议。

两个 API 看似同义，真正的输入契约并不一样

官方文档把 LookupHost 定义为使用本地 resolver 查找 host，并返回地址字符串切片；Resolver.LookupIP 则多了一个 network 参数，允许调用方选择 ip、ip4 或 ip6。所以下面两次调用并不是完全等价的对照：

ctx := context.Background()
resolver := net.DefaultResolver

// LookupHost 不指定地址族，拿到的是适合展示或继续解析的字符串。
hosts, err := resolver.LookupHost(ctx, "example.com")
if err != nil {
	log.Printf("LookupHost failed: %v", err) // 保留原始错误，便于判断 DNS 失败类型
}

// LookupIP 的 network 会改变查询结果集合：ip4/ip6 是明确的筛选契约。
ips, err := resolver.LookupIP(ctx, "ip4", "example.com")
if err != nil {
	log.Printf("LookupIP failed: %v", err) // 不把空切片误当成成功
}
fmt.Println(hosts, ips)

先把 ip、ip4、ip6 的差异排除，再比较内容

如果 LookupHost 返回两类地址，而你把它和 LookupIP(ctx, "ip4", host) 比较，少掉 IPv6 是预期行为，不是接口不一致。另一个常见误会是直接用 fmt.Println 比较字符串与 net.IP：它们的展示形式不同，但可以通过 String() 统一为文本。

func onlyIPv4(ctx context.Context, host string) ([]string, error) {
	// 明确只接受 IPv4，避免把双栈结果交给只支持 IPv4 的下游。
	ips, err := net.DefaultResolver.LookupIP(ctx, "ip4", host)
	if err != nil {
		return nil, fmt.Errorf("lookup IPv4 for %s: %w", host, err) // 包装 host，保留可追踪上下文
	}
	result := make([]string, 0, len(ips))
	for _, ip := range ips {
		result = append(result, ip.String()) // 只在边界层转换，内部仍保留 net.IP
	}
	return result, nil
}

反过来，如果连接器支持双栈，应该传 ip，再根据连接策略处理地址，而不是先调用 LookupHost 后凭字符串格式猜地址族。还要注意返回顺序：DNS 响应、本地 resolver 和系统实现都可能影响顺序，业务代码不要把第一个地址永久当成唯一首选。

本地 resolver 会让“同一个域名”出现部分结果

Go 在 Unix 系统上可能使用纯 Go resolver，也可能转到 cgo/系统库；是否偏好 Go resolver、/etc/resolv.conf、系统名称服务配置和环境变量，都会影响解析路径。Resolver.StrictErrors 也值得单独看：当双栈查询拆成多个子查询时，临时错误可能被当作部分结果返回，也可能让整个查询失败。

因此遇到“LookupHost 有地址、LookupIP 报错”时，先记录调用的 network、host、错误类型和 resolver 配置，再判断是不是地址族被过滤或其中一条子查询失败。生产日志至少应保留 host、network、耗时、错误和结果数量；不要只记录“DNS 失败”。

按任务选 API，避免把差异当成故障

• 要给用户展示解析地址：LookupHost 足够，但不要承诺顺序。
• 要固定 IPv4/IPv6：使用 Resolver.LookupIP 的 ip4 或 ip6。
• 要做双栈诊断：使用 ip，同时记录部分结果和错误，不要静默吞掉 error。
• 要建立连接：让连接策略决定地址顺序，DNS 查询只负责提供候选地址。

常见问题

LookupIP("ip") 一定和 LookupHost 返回相同地址吗？

不保证。它们的地址族范围可能接近，但返回类型、解析路径、错误处理和结果顺序都可能不同。

为什么 LookupIP 的 network 传错会直接报错？

因为该参数是明确契约，只能使用 ip、ip4 或 ip6；不要把 tcp、udp 当成这里的网络族。

只需要一个可连接地址该怎么做？

先按连接能力选择地址族，再让连接器尝试候选地址；不要依赖 DNS 返回切片的第一个元素。