Go net.LookupCNAME 返回别名时如何区分查询失败

使用 net.LookupCNAME 时，判断查询是否成功不能只看返回的字符串，更不能把“没有 CNAME 记录”直接当成错误。它返回的是主机经过零条或多条 CNAME 记录后得到的最终规范化名称；只要主机仍能解析到地址记录，即使没有 CNAME，调用也可以返回成功。真正的查询失败应以第二个返回值 err 为准。

官方地址：https://pkg.go.dev/net@go1.27.3#LookupCNAME

实用判断顺序是先看 err，再解释 cname：err == nil 表示解析链得到的名称可用；它不表示一定存在显式 CNAME 记录。若 err != nil，应保留错误上下文，不要用空字符串重新包装成“没有别名”。

LookupCNAME 返回的到底是什么

Go 官方文档把 canonical name 定义为跟随零条或多条 CNAME 记录后得到的最终名称。因此，LookupCNAME 的关注点是“这个主机最终对应哪个规范化名称”，不是把 DNS 响应中的每一条别名原样交给调用方。

标准库还明确说明：目标主机不包含 DNS CNAME 记录时，只要它能解析到地址记录，LookupCNAME 也不会因此返回错误。这个语义是排查误判的关键：没有别名记录是一个成功结果的可能形态，而不是失败原因。

先看 err，再解释 cname

最小写法是同时接收两个返回值。成功时使用 cname；失败时优先处理 err。不要使用“字符串为空就失败”的单条件，因为 DNS 语义和错误语义并不是同一个维度。

package main

import (
	"fmt"
	"net"
)

func main() {
	// 同时接收规范化名称和错误，避免把“无 CNAME”误判成查询失败。
	cname, err := net.LookupCNAME("example.com")
	if err != nil {
		// 保留原始错误，便于区分不存在、超时和解析器返回的其他错误。
		fmt.Printf("CNAME 查询失败: %v\n", err)
		return
	}

	// err 为 nil 时，cname 是标准库确认过格式的表示形式。
	fmt.Printf("规范化名称: %s\n", cname)
}

这里的“成功”并不承诺 example.com 一定配置了显式 CNAME。它只说明解析器返回了可接受的规范化名称。业务代码如果还需要知道“是否存在 CNAME 记录”，应把这个问题交给专门的 DNS 记录查询或配置数据，而不是从 LookupCNAME 的返回字符串猜测。

需要超时和取消时使用 Resolver.LookupCNAME

包级函数内部使用 context.Background()。服务端请求、任务队列或批量探测通常需要把调用绑定到请求生命周期，这时应创建 Resolver 并调用带上下文的方法。

package main

import (
	"context"
	"fmt"
	"net"
	"time"
)

func lookup(ctx context.Context, host string) (string, error) {
	// Resolver.LookupCNAME 让 DNS 查询继承调用方的取消和截止时间。
	resolver := net.Resolver{}
	cname, err := resolver.LookupCNAME(ctx, host)
	if err != nil {
		// 不把超时、取消或 DNS 错误伪装成“没有别名”。
		return "", fmt.Errorf("lookup CNAME %q: %w", host, err)
	}
	return cname, nil
}

func main() {
	// 示例只构造调用边界，不把网络结果写死在业务逻辑中。
	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
	defer cancel() // 及时释放定时器资源。
	_, _ = lookup(ctx, "example.com")
}

使用 %w 包装后，调用方仍可以用 errors.Is 或 errors.As 继续判断底层错误。这样日志里有主机和业务上下文，错误分类又不会丢失。

三个结果不要混为一谈

最后还要注意，标准库会校验返回名称是否符合 presentation-format 域名格式；格式不合法时会返回错误。因此“返回了字符串”也不能替代对 err 的判断。

常见追问

没有 CNAME 时 LookupCNAME 会返回空字符串吗？

不能把空字符串作为通用结论。标准库语义是：没有 CNAME 记录但主机能解析到地址记录时，不因此返回错误；具体返回值仍应和 err 一起解释。

只想拿到 IP，还需要调用 LookupCNAME 吗？

通常不需要。官方源码建议不关心 canonical name 时直接使用 LookupHost 或 LookupIP，它们会在解析地址时处理规范化名称。