Go net.IP.IsLoopback 怎样判断地址是否为回环地址

Go 里判断一个 IP 是否属于回环地址，直接调用 net.IP.IsLoopback() 即可。它把 IPv4 的 127.0.0.0/8 和 IPv6 的 ::1 归为回环地址；普通地址、未指定地址、私有地址以及解析失败的输入都不应靠字符串前缀猜测。实际代码应先用 net.ParseIP 得到 net.IP，再根据 nil 和 IsLoopback 的结果分支。

官方资料：https://pkg.go.dev/net#IP.IsLoopback

最短判断路径：先解析输入，再调用 ip.IsLoopback()；不要把“绑定所有本地接口”的 0.0.0.0 或内网地址当成回环地址。

IsLoopback 到底判断哪些地址

IsLoopback 的职责很窄：只回答“这个 IP 是否是回环地址”。IPv4 中只要第一个字节是 127，就落在 127.0.0.0/8；IPv6 的回环地址是单独的 ::1。因此 127.0.0.1、127.20.30.40 和 ::1 会返回 true，192.168.1.10、8.8.8.8 与 2001:db8::1 会返回 false。

先用 ParseIP 处理字符串输入

业务输入通常来自配置、请求参数或日志，类型是字符串。net.ParseIP 能解析常见的 IPv4 和 IPv6 文本；输入不合法时返回 nil。这一步要和回环判断分开，否则把解析失败直接当成“不是回环”可能会掩盖坏配置。

package main

import (
    "fmt"
    "net"
)

// classifyIP 先区分非法输入，再判断合法 IP 是否为回环地址。
func classifyIP(text string) string {
    // ParseIP 失败时返回 nil，先把输入错误与地址类别区分开。
    ip := net.ParseIP(text)
    if ip == nil {
        return "invalid"
    }

    // IsLoopback 同时覆盖 IPv4 的 127/8 和 IPv6 的 ::1。
    if ip.IsLoopback() {
        return "loopback"
    }
    return "non-loopback"
}

func main() {
    // 这些输入覆盖 IPv4、IPv6、普通地址和格式错误四种常见边界。
    inputs := []string{"127.0.0.1", "::1", "192.168.1.10", "not-an-ip"}
    for _, input := range inputs {
        fmt.Printf("%s -> %s\n", input, classifyIP(input))
    }
}

这段代码的返回值把输入分成三类：invalid 表示文本不是合法 IP，loopback 表示合法且属于回环范围，non-loopback 表示合法但不是回环。生产代码可以把这三类映射到配置错误、仅本机处理和普通网络处理，而不是用字符串比较 127.0.0.1。

为什么不要手写字符串前缀

直接写 strings.HasPrefix(text, "127.") 看似简单，却漏掉 IPv6 的 ::1，也容易把格式清洗、前导空格和 IPv4-mapped IPv6 的表示混到业务规则里。更重要的是，字符串前缀只是在猜文本，不是在判断已经解析过的地址。

如果输入是 ::ffff:127.0.0.1 这种 IPv4-mapped IPv6 表示，先交给 ParseIP，再由 IsLoopback 做语义判断更稳妥。不要先把文本截断成 IPv4 字符串，也不要因为看到冒号就把它排除。

func isLoopbackText(text string) (bool, error) {
    // 解析失败必须返回错误，避免把坏输入静默归入普通地址。
    ip := net.ParseIP(text)
    if ip == nil {
        return false, fmt.Errorf("非法 IP 地址: %q", text)
    }

    // 由标准库统一处理 IPv4、IPv6 和 IPv4-mapped IPv6 的表示差异。
    return ip.IsLoopback(), nil
}

这里的函数没有把“是否回环”和“输入是否合法”合成一个含糊的布尔值。调用方可以决定非法输入是拒绝请求、回退默认配置，还是记录诊断日志。

区分回环、未指定、私有和链路本地地址

网络排障中最容易混淆的是几种都“看起来特殊”的地址。回环地址只表示本机协议栈内部的回送路径；0.0.0.0 和 :: 是未指定地址，常用于表示尚未选择具体本地地址；私有地址用于内网范围；链路本地地址只在相邻链路范围内使用。它们要用不同的标准库方法判断。

尤其要注意：私有地址和回环地址都可能出现在“本地开发环境”里，但网络语义完全不同。若业务规则是“禁止访问本机服务”，仅判断 IsPrivate 不够；若规则是“只允许局域网地址”，也不能只判断 !IsLoopback。

用表格测试覆盖 IPv4、IPv6 和无效输入

这个方法本身很小，但输入表示的边界值得用表格测试固定下来。测试时至少覆盖整个 127/8，而不是只测一个回环地址；同时加入未指定、私有、链路本地、IPv4-mapped IPv6 和非法文本。

package main

import (
    "net"
    "testing"
)

func TestIsLoopbackInput(t *testing.T) {
    // 表格同时记录合法性与回环期望，避免把 nil 当作普通地址。
    cases := []struct {
        name     string
        input    string
        valid    bool
        loopback bool
    }{
        {name: "ipv4-loopback-range", input: "127.200.1.8", valid: true, loopback: true},
        {name: "ipv6-loopback", input: "::1", valid: true, loopback: true},
        {name: "mapped-loopback", input: "::ffff:127.0.0.1", valid: true, loopback: true},
        {name: "unspecified", input: "0.0.0.0", valid: true, loopback: false},
        {name: "private", input: "192.168.1.10", valid: true, loopback: false},
        {name: "invalid", input: "300.1.1.1", valid: false, loopback: false},
    }

    for _, tc := range cases {
        t.Run(tc.name, func(t *testing.T) {
            // 先检查 ParseIP 的合法性，再检查 IsLoopback 的语义结果。
            ip := net.ParseIP(tc.input)
            if (ip != nil) != tc.valid {
                t.Fatalf("valid=%v, want %v", ip != nil, tc.valid)
            }
            if ip != nil && ip.IsLoopback() != tc.loopback {
                t.Fatalf("IsLoopback=%v, want %v", ip.IsLoopback(), tc.loopback)
            }
        })
    }
}

如果项目只接受 IPv4，可以在解析后额外调用 To4 做类型约束；如果同时支持 IPv6，则不要为了得到四字节切片而先调用 To4，否则会把 IPv6 的 ::1 排除在判断之外。

常见问题

127.0.0.1 和 127.20.30.40 都是回环地址吗？

是。IPv4 回环范围是 127.0.0.0/8，不是只包含一个常见的 127.0.0.1。

0.0.0.0 是回环地址吗？

不是。它是未指定 IPv4 地址，应该用 IsUnspecified 判断。监听配置中的“绑定所有本地接口”和“只访问本机回环”是两件不同的事。

判断本机地址能不能只用 IsLoopback？

不能。IsLoopback 只识别回环范围；网卡枚举、私有网段、容器网络和代理地址属于其他问题，需要按业务语义补充判断。

ParseIP 返回 nil 时还能调用 IsLoopback 吗？

不建议。虽然方法调用的接收者是切片类型，但应先判断解析结果，再把非法输入作为错误处理，避免坏配置被悄悄当成普通地址。

小结

net.IP.IsLoopback 是判断回环语义的标准入口：IPv4 看 127/8，IPv6 看 ::1。推荐的工程写法是 ParseIP → 判断 nil → IsLoopback，并把未指定、私有、链路本地地址分别交给对应方法。这样既覆盖双栈输入，也不会把“能在本机看到”误写成“就是回环地址”。