Go netip.AddrFromSlice 怎样从字节切片解析 IP 地址

从网络协议、数据库字段或 net.IP 里拿到一段 IP 字节时，可以用 netip.AddrFromSlice 统一转换为更现代的 netip.Addr。它的规则很简单：长度为 4 按 IPv4 解析，长度为 16 按 IPv6 解析，其他长度返回无效地址和 false。

官方文档：https://pkg.go.dev/net/netip#AddrFromSlice

不要只检查返回的地址对象。AddrFromSlice 的第二个返回值 ok 才是长度是否符合要求的明确结果；长度错误时必须先处理 ok=false。

AddrFromSlice 实际读取的是什么

这个函数不解析 "192.0.2.10" 这样的文本，而是直接读取已经按网络字节表示准备好的切片。4 个字节代表 IPv4，16 个字节代表 IPv6。返回类型是 (netip.Addr, bool)，第二个值表示输入长度是否有效。

它也能直接接收 net.IP，因为 net.IP 的底层类型就是 []byte。这适合网络库已经拿到二进制地址、但业务代码希望换成可比较且不可变的 netip.Addr 的场景。

用同一个函数解析 IPv4 和 IPv6

下面的示例把解析逻辑收口到一个小函数中。调用方只负责准备字节，解析函数负责检查 ok 并把错误变成可读信息。代码中的注释说明了长度契约和返回值用途。

package main

import (
    "fmt"
    "net/netip"
)

// parseAddrBytes 只接受 IPv4 的 4 字节或 IPv6 的 16 字节表示。
func parseAddrBytes(raw []byte) (netip.Addr, error) {
    ip, ok := netip.AddrFromSlice(raw)
    if !ok {
        // AddrFromSlice 失败时返回 Addr{}；这里用长度补充可定位的错误信息。
        return netip.Addr{}, fmt.Errorf("IP 字节长度必须是 4 或 16，收到 %d", len(raw))
    }
    return ip, nil
}

func main() {
    samples := [][]byte{
        {192, 0, 2, 10},
        {0x20, 0x01, 0x0d, 0xb8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1},
        {192, 0, 2}, // 长度既不是 4，也不是 16，用来演示错误分支。
    }

    for _, raw := range samples {
        ip, err := parseAddrBytes(raw)
        if err != nil {
            fmt.Println("解析失败：", err)
            continue
        }

        // Is4、Is6 和 String 用来描述解析后的地址，而不是替代 ok 检查。
        fmt.Printf("%s IPv4=%t IPv6=%t\n", ip, ip.Is4(), ip.Is6())
    }
}

这里的关键不是把字节转成字符串，而是先守住输入长度。对于 4 字节数据，得到的地址会被识别为 IPv4；对于 16 字节数据，得到的是 IPv6。长度为 3 的切片不会被“猜测”为一个不完整的 IPv4 地址。

长度错误时为什么一定要检查 ok

当切片长度不是 4 或 16 时，官方契约是返回 netip.Addr{} 和 false。零值地址不是可用的 IP 地址，而且它与 0.0.0.0、:: 也不是同一个概念。

因此下面两种写法都不稳妥：

• 只接收第一个返回值，然后直接调用 String；
• 把 Addr{} 的字符串表现当成输入是 0.0.0.0 或 ::。

更可靠的边界处理是：先判断 ok，失败时记录原始长度或上游字段来源；成功后再使用 Is4、Is6、Is4In6 和 String 等方法。

16 字节的 IPv4 映射地址仍然是 IPv6

有些网络数据会把 IPv4 表示成 IPv4-mapped IPv6，例如 ::ffff:192.0.2.10。只要输入是 16 字节，AddrFromSlice 就按 IPv6 解析，返回的 netip.Addr 会保留 IPv6 形态。需要统一成 IPv4 视角时，再显式调用 Unmap。

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    mapped := []byte{
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0xff, 0xff, 192, 0, 2, 10,
    }

    ip, ok := netip.AddrFromSlice(mapped)
    if !ok {
        // 这里长度是 16；若失败，说明调用方给出的切片并非预期数据。
        fmt.Println("无效的 IP 字节")
        return
    }

    // 先保留原始 IPv6 语义；只有业务需要 IPv4 视角时才 Unmap。
    fmt.Println("原始：", ip, "Is4In6=", ip.Is4In6())
    fmt.Println("去映射：", ip.Unmap(), "Is4=", ip.Unmap().Is4())
}

这一步适合做地址归一化，但不要无条件把所有 16 字节输入都当成 IPv4。普通 IPv6 地址不能通过 Unmap 变成 IPv4，业务判断应保留原始地址类型。

AddrFromSlice、AddrFrom4、AddrFrom16 怎么选

如果数据源本来就是切片，优先用 AddrFromSlice，因为它能通过长度同时覆盖 IPv4 和 IPv6，并用 ok 报告输入是否符合契约。如果数据在编译期或业务结构中已经是定长数组，则可以选择更明确的入口：

AddrFrom4 和 AddrFrom16 的优势是输入类型更明确；它们接收数组，不会像切片那样在运行时因为长度不对而返回 ok=false。而从协议报文、net.IP 或二进制字段读取数据时，切片通常更自然。

几个容易混淆的边界

1. 不要把文本传给 AddrFromSlice。 文本地址应该用 netip.ParseAddr，二进制地址才用 AddrFromSlice。
2. 不要忽略 ok。 返回的零值地址不能代表业务上的未指定地址。
3. 不要按内容猜版本。 4 字节是 IPv4，16 字节按 IPv6 处理；IPv4 映射形式要通过 Is4In6 或 Unmap 显式判断。
4. 不要修改输入来“补齐”长度。 如果上游字段长度异常，应在协议解析或数据清洗层报告错误。

总结

netip.AddrFromSlice 的使用可以记成三句话：4 字节解析 IPv4，16 字节解析 IPv6，其他长度检查 ok=false。数据已经是定长数组时用 AddrFrom4 或 AddrFrom16；数据是文本时改用 ParseAddr。如果 16 字节输入是 IPv4-mapped IPv6，也先保留它的 IPv6 语义，确认业务需要后再 Unmap。

相关问题

• AddrFromSlice 能直接接收 net.IP 吗？ 可以，net.IP 可作为 []byte 传入，但仍要检查长度和 ok。
• 长度为 16 的 IPv4 数据会自动变成 IPv4 吗？ 不会，16 字节按 IPv6 解析；IPv4 映射地址需要用 Unmap 转换视角。
• 什么时候应该用 ParseAddr？ 输入来自配置文件、命令行或 JSON 等文本字段时，用 ParseAddr 并处理 error。