Go netip.Addr.IsMulticast 怎样判断地址是否为组播

判断 IP 地址是否为组播，先用 netip.ParseAddr 解析输入，再调用 addr.IsMulticast()。它识别 IPv4 的 224.0.0.0/4 和 IPv6 的 ff00::/8；IPv4 映射的 IPv6 地址也会按所包裹的 IPv4 地址判断。解析错误必须单独处理，不能把它当成“合法但非组播”。

我在组织配置分类代码时，更愿意把“字符串是否合法”和“地址属于哪类”分成两件事。这样看到 false 时，读者不用猜输入究竟是普通地址、未初始化的零值，还是一个拼错的配置项。这里讨论标准库已有能力及旧写法的调整，不把它描述成某次新版本刚发生的变化。

官方地址：https://pkg.go.dev/net/netip

把字符串判断换成地址类型判断

如果手头是用户填写的地址，最小入口可以返回 (bool, error)。布尔值只承载组播分类；错误承载输入无法解析这一事实。不要先取字符串首段，再用“224 到 239”或“ff 开头”代替 IP 解析，因为 IPv6 的大小写、缩写和映射表示不应该交给零散字符串规则处理。

package main

import (
    "fmt"
    "net/netip"
)

// IsMulticastText 将输入错误与地址分类分开返回。
func IsMulticastText(text string) (bool, error) {
    addr, err := netip.ParseAddr(text)
    if err != nil {
        return false, fmt.Errorf("地址格式无效: %w", err)
    }
    return addr.IsMulticast(), nil
}

func main() {
    inputs := []string{"239.18.7.9", "ff02::7", "192.0.2.44", "bad-ip"}
    for _, text := range inputs {
        multicast, err := IsMulticastText(text)
        if err != nil {
            // 无效输入不参与普通地址与组播地址的分类。
            fmt.Printf("%q: %v\n", text, err)
            continue
        }
        fmt.Printf("%s: multicast=%t\n", text, multicast)
    }
}

按接口语义，前两个有效输入应得到 true，文档示例用的普通 IPv4 地址得到 false，最后一个输入进入错误分支。这些是便于理解的预期结果，不是本机运行记录。程序不进行 DNS 查询，也不创建网络连接。

ParseAddr 面向地址本身，不接收域名、CIDR 前缀或地址端口组合。比如配置写成 239.18.7.9:7000，应按字段契约使用 ParseAddrPort，取得 Addr() 后再分类；如果字段要求纯 IP，就直接报告格式不符。不要在解析失败后随意截掉冒号后面的文字，IPv6 地址本身就包含冒号。

为什么 IPv4、IPv6 和映射地址能共用入口

这个方法的价值在于把地址表示细节交给 netip.Addr。IPv4 的组播范围是 224.0.0.0 到 239.255.255.255，也就是 224.0.0.0/4；IPv6 组播地址属于 ff00::/8。范围判断只回答地址类别，不能证明某个具体组地址已经分配、存在接收者或能够到达。

对应标准可参阅 RFC 1112 与 RFC 4291。标准库的 官方实现还明确处理了 IPv4 映射地址：先取其 IPv4 语义，再做组播判断。

我最初容易把“它是 IPv6 表示”与“它只能按 IPv6 组播前缀判断”混为一谈。像 ::ffff:239.18.7.9 这样的输入，Is4() 为 false，Is4In6() 为 true，但 IsMulticast() 仍为 true。这里并不矛盾：地址族表示与组播分类是两个不同问题。

图中的 Unmap 用于解释映射地址的 IPv4 语义，不表示调用者必须手动执行它。仅为了调用 IsMulticast，不需要先写一遍 addr.Unmap()。若项目还要统一日志、比较值或地址键，则另行决定是否归一化，并保持所有入口一致。

对于 ff02::7%eth0 这类带 zone 的 IPv6 地址，组播分类关注地址位；zone 不会把组播地址变成单播地址。不过分类成功并不意味着 eth0 在当前机器上存在，解析也不是网卡可用性检查。

旧代码最容易误判的零值与非组播地址

netip.Addr{} 是无效零值，IsMulticast() 返回 false。0.0.0.0 和 :: 则是可以解析的未指定地址，IsValid() 为 true，组播判断同样为 false。它们有相同的组播布尔值，却有不同的输入含义。

// 当输入已经是 Addr 时，仍要区分无效零值。
func ClassifyAddr(addr netip.Addr) string {
    if !addr.IsValid() {
        return "无效地址"
    }
    if addr.IsMulticast() {
        return "组播地址"
    }
    // 这里只能说非组播，不能推断可公网访问。
    return "有效非组播地址"
}

上面是补充到导入 net/netip 的代码文件中的函数片段。对外接口若需要稳定机器可读状态，适合用枚举或结构字段；中文字符串只是文章中的直观展示。

另一个容易写反的判断是用 !addr.IsGlobalUnicast() 代替 addr.IsMulticast()。两者不是互补关系：回环、未指定地址等都可能使 IsGlobalUnicast() 返回 false，但并非组播。反过来，IPv4 私有地址、IPv6 ULA 地址也可能让 IsGlobalUnicast() 返回 true；方法名称不能解释成“公网可达”。这些边界在 官方方法说明中有明确限定。

迁移配置分类时保留错误和原始表示

如果旧系统只有一个布尔字段，我会先问调用方是否需要区分“输入不合法”和“不是组播”。大多数配置入口需要区分，否则一个拼写错误会悄悄落入普通地址分支。最稳妥的调整是在解析阶段返回错误，而不是给原布尔值增加新的模糊约定。

如果内部函数已经接收 netip.Addr，无需再把它转成字符串后重新解析。直接检查 IsValid() 和 IsMulticast() 即可。对于原本接收 net.IP 的接口，迁移之前要确定上游是否依赖 nil、切片表示或地址族信息，不应只改类型名字便认为迁移完成。

映射表示值得单独保留一条约定。Unmap() 返回转换后的值，不会原地改变原变量。假如记录原始配置有业务意义，就保存原始文本或原始 Addr；如果用于去重的键要求 IPv4 与其映射形式视为同一个地址，则在那个边界统一归一化。组播分类本身不会替你修改已有 map 的键。

// 展示映射地址的分类与归一化各自承担什么职责。
func DescribeMapped(text string) (string, error) {
    addr, err := netip.ParseAddr(text)
    if err != nil {
        return "", fmt.Errorf("地址格式无效: %w", err)
    }
    normalized := addr.Unmap()
    return fmt.Sprintf("原表示=%s, 归一化=%s, 组播=%t",
        addr, normalized, addr.IsMulticast()), nil
}

这个函数片段需要 fmt 与 net/netip 两个导入。它有意同时展示原表示和归一化结果，让调用方知道转换发生在哪里；若只是组播布尔判断，不必引入这层描述函数。

本文的分类入口适合配置检查、地址清单分组和显示标签。它不会加入组播组、选择发送网卡或验证网络传输是否成功；这些是套接字与运行环境的任务，不能由地址分类结论替代。

用边界样例理解分类结果

对于调用方自己的回归样例，我会保留几组不容易被“看起来像地址”蒙混过去的输入。IPv4 选范围两侧与范围端点，IPv6 选组播与非组播，再加映射地址、非法文本和零值。这里列出的是根据文档与方法定义得到的预期，不声称执行过本地测试。

边界表适合帮助维护者发现自己包装函数中的逻辑错误。不要因此重写标准库的位运算判断；业务更需要维护的是输入格式约定、错误去向，以及多种表示是否需要统一。

IsMulticast 返回 true，是否说明已经有接收者？

不能。该方法只看地址类别，不发网络请求，不查询组成员，也不证明某条链路支持组播转发。

是不是所有非组播地址都是全局单播？

不是。零值、未指定地址、回环以及广播等情况说明，非组播的集合比全局单播更广。需要哪种分类就调用对应方法，不用布尔取反拼出另一种地址类别。

是否需要先调用 Unmap？

仅为了组播判断不需要，方法会处理 IPv4 映射地址。只有其他比较、日志或键值策略需要统一表示时，再显式考虑 Unmap。

对我的配置分类场景而言，最有用的改动是让解析错误可见，并让组播判断只负责组播判断。这样既能保留输入边界，也能让 IPv4 与 IPv6 走同一个清楚的标准库入口。