Go netip.ParseAddr 怎样处理带 zone 的 IPv6 地址

如果日志里出现 fe80::1%eth0，不要先把百分号后的内容截掉。它表示 IPv6 的作用域 zone，常见于链路本地地址。Go 的 netip.ParseAddr 可以直接解析这种文本，并把地址主体和 zone 一起保存在值类型 netip.Addr 中。真正需要做的是检查错误、读取 Zone()，以及在带端口时改用 ParseAddrPort。

本文只讨论文本解析和作用域信息的保留，不负责 DNS 查询，也不根据 zone 自动枚举网卡。

带 zone 的 IPv6 地址到底多了什么

普通 IPv6 可以写成 2001:db8::68，带作用域的 IPv6 则可能写成 fe80::1%eth0。前半段是 IPv6 地址，%eth0 是作用域标记。它不是端口，也不是地址主体的一部分；如果在链路本地地址上删掉它，文本虽然看起来更短，但可能失去定位接口所需的信息。

ParseAddr 成功和失败都要检查

ParseAddr 返回 (netip.Addr, error)。成功时用 Is6 判断地址族，用 Zone 读取作用域；失败时不要继续使用零值地址。下面的示例把输入、错误和展示分开，便于把原始地址写入排障日志：

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    samples := []string{"fe80::1%eth0", "2001:db8::68", "fe80::1%"}
    for _, text := range samples {
        addr, err := netip.ParseAddr(text)
        if err != nil {
            // 解析失败时保留原始文本，避免把错误输入误当成零值地址。
            fmt.Printf("parse %q failed: %v\n", text, err)
            continue
        }
        // Zone 为空表示普通地址；非空时说明作用域信息被保留下来。
        fmt.Printf("addr=%s ipv6=%t zone=%q\n", addr, addr.Is6(), addr.Zone())
    }
}

示例中的 fe80::1% 没有有效的 zone，会进入错误分支。不要只判断 addr.IsValid() 就跳过 error，调用约定仍然是先处理错误，再使用返回值。

怎样读取、替换和显示 zone

拿到 Addr 后，Zone() 只返回作用域文本；String() 会把它重新带回规范化后的字符串。需要替换或清除作用域时，可以使用 WithZone，但这仍然只是值对象变换，不会探测系统接口是否真的存在。

func showZone(text string) error {
    addr, err := netip.ParseAddr(text)
    if err != nil {
        // 把解析错误交给调用方，避免静默改写网络地址。
        return fmt.Errorf("parse address %q: %w", text, err)
    }

    fmt.Println("original:", addr.String())
    fmt.Println("zone:", addr.Zone())
    fmt.Println("without zone:", addr.WithZone("").String())
    // WithZone 只构造新的值，不验证 zone 是否对应真实网卡。
    fmt.Println("renamed zone:", addr.WithZone("lan0").String())
    return nil
}

带端口时不要继续用 ParseAddr

ParseAddr 的输入是地址，不是地址加端口。带端口的 IPv6 文本应使用 netip.ParseAddrPort，并给 IPv6 地址加方括号，例如 [fe80::1%eth0]:8080。这样端口和 zone 的边界由标准库处理，不需要手工按冒号切割。

func parseEndpoint(text string) (netip.AddrPort, error) {
    endpoint, err := netip.ParseAddrPort(text)
    if err != nil {
        // 地址端点错误要原样返回，调用方可决定是否重试或拒绝请求。
        return netip.AddrPort{}, fmt.Errorf("parse endpoint %q: %w", text, err)
    }
    return endpoint, nil
}

常见误区和结论

• 不要把 zone 当端口，也不要用字符串分割冒号来解析 IPv6。
• 不要默认清除百分号后的内容；链路本地地址可能因此失去作用域。
• WithZone 不会验证网卡，真实连通性仍由后续网络操作决定。

记住一条规则：单独的 IP 地址用 ParseAddr，带端口的端点用 ParseAddrPort；成功后用 Zone() 判断作用域是否存在，失败后先处理 error。

相关问题

为什么 IPv6 带端口必须加方括号？ 因为 IPv6 地址本身包含多个冒号，方括号用于明确地址与端口的分界。

Zone 为空是不是解析失败？ 不是。普通 IPv4 和普通 IPv6 都可以合法解析，只是没有作用域标记。

ParseAddr 会解析主机名吗？ 不会，它解析的是数字形式的 IP 地址文本；主机名解析属于 DNS 或其他网络解析流程。