Go x/net/publicsuffix.EffectiveTLDPlusOne 为什么拒绝公共后缀

EffectiveTLDPlusOne 要返回公共后缀再加左侧一个标签。输入如果就是公共后缀，便没有这个额外标签，所以函数无法得到 eTLD+1 并返回错误。这不是后缀表失效。要查询后缀本身，使用 PublicSuffix；要取得用于域名归并的 eTLD+1，才使用 EffectiveTLDPlusOne。

官方文档：https://pkg.go.dev/golang.org/x/net/publicsuffix

确认输入需要的是公共后缀还是归并域

假设正在整理一份站点清单，输入既有完整主机名，也有用户手工填入的后缀。如果把所有失败都归为“域名格式错误”，就会混淆两件事：输入标签结构是否符合约定，以及它是否有足够标签组成 eTLD+1。我的处理建议是让这两种状态分别留在记录中，而不是用原字符串掩盖失败。

这里的公共后缀不一定只有一个标签。例如 co.uk 含两个标签，因此“永远取最后两段”的规则不能代替后缀表。本文使用“归并域”描述 eTLD+1 的应用用途，不把结果等同于域名一定可购买、已注册或可访问。

从公共后缀理解缺少的一个标签

以 co.uk 为例，公共后缀本身已经占满输入；换成 example.co.uk，才多出 example 这一标签。再往左增加 shop，也不会让归并结果把所有子域都带上。这些是按接口与后缀规则推导的对照，不是本文实际运行日志。

实现先取得后缀，再判断输入能否提供额外标签。它还会拒绝前导点、尾点和连续点引起的空标签。因此不能把所有错误都解释为“输入恰好是公共后缀”，还要保留真实错误和输入。

分别记录查询结果与错误

下面完整示例让输入、后缀、归并域与错误保持独立。Inspect 的前提是传入规范化的小写域名；它不负责解析用户输入的 URL，也不是完整域名合法性验证器。

package main

import (
    "fmt"
    "golang.org/x/net/publicsuffix"
)

type DomainRecord struct {
    Host string
    Suffix string
    ICANN bool
    GroupDomain string
    Err error
}

// Inspect 的输入约定是已规范化的小写域名，不是 URL、端口或 IP。
func Inspect(host string) DomainRecord {
    suffix, icann := publicsuffix.PublicSuffix(host)
    group, err := publicsuffix.EffectiveTLDPlusOne(host)
    return DomainRecord{
        Host: host, Suffix: suffix, ICANN: icann,
        GroupDomain: group, Err: err, // 错误与正常结果分别保存。
    }
}

func main() {
    // 这些常量仅用于对照后缀本身与拥有额外标签的域名。
    for _, host := range []string{"co.uk", "shop.example.co.uk", "com", "example.com"} {
        row := Inspect(host)
        if row.Err != nil {
            fmt.Printf("host=%q suffix=%q 无归并域: %v\n",
                row.Host, row.Suffix, row.Err)
            continue // 不把原输入写回成功归并字段。
        }
        fmt.Printf("host=%q suffix=%q group=%q icann=%t\n",
            row.Host, row.Suffix, row.GroupDomain, row.ICANN)
    }
}

该写法的关键不是错误信息的字面内容，而是 error 是否为空。不要依赖字符串 contains 来决定成功，也不要在失败后直接把 host 填入 GroupDomain，否则公共后缀会悄悄混入正常归并结果。

真实入口若接收 URL，应先用适合的 URL 解析逻辑提取主机名，明确处理端口、IP 地址、大小写、国际化域名和末尾根点。本文没有用随意截字符串的代码把这些工作塞进 Inspect，也不建议用 Trim 任意删掉前后点来修复所有输入：那可能让原本异常的字符串变成另一种输入。

为归并记录保留输入与规则来源

对需要保存的归并记录，我倾向保留原始输入、规范化后的 host、suffix、成功的 eTLD+1、错误状态和所用模块版本。这样同一条来源数据在升级规则后发生结果变化时，可以解释差异来自输入处理还是后缀快照。

包使用编译进库的公共后缀数据，不是在每次调用时联网查询。更新规则数据需要结合模块依赖管理。应用也不能用一次 eTLD+1 成功来证明 DNS 解析成功、注册状态正确或当前服务可用；这些不是这个函数的工作。

PublicSuffix 返回的 icann=false 也不等同于“非法域名”。它可能涉及私有后缀或未被列表显式管理的顶级标签。不要把它机械当成拒绝所有域名的条件，是否接受由业务规则明确决定。

常见疑问和处理选择

查询公共后缀成功，为什么 eTLD+1 失败？两个问题要求的结构不同。后者还需要后缀左侧至少一个可用标签。

能不能直接返回后缀作为备用结果？若只是展示诊断信息，可以单独展示 suffix；不要把它放入代表成功归并的字段，否则下游无法区分两者。

有两个点就一定能取得 eTLD+1 吗？不能。公共后缀可能包含多个标签，实际边界由后缀规则决定，不是单纯数点。

这个函数可以判断域名是否已经注册吗？不能。它根据规则计算名称边界，不执行注册信息查询。

参考：EffectiveTLDPlusOne 文档、官方实现。