ipv6地址字面量必须用方括号包裹,否则go标准库解析失败;url、监听地址、多播绑定等场景均需显式使用[::]或[2001:db8::1]格式,并注意zone id处理与双栈配置。

IPv6地址字面量必须用方括号包裹,否则net.ParseIP或URL解析会失败
Go标准库对IPv6地址的解析非常严格:裸写2001:db8::1在多数上下文中会被截断或误判为IPv4。比如传给net.Dial时,若没加方括号,Go会尝试按IPv4解析冒号前部分,直接报invalid port或lookup 2001: no such host。
- 所有含IPv6字面量的URL必须写成
http://[2001:db8::1]:8080,不能省略[] -
net.ParseIP("2001:db8::1")能正确返回IPv6地址,但net.ParseIP("2001:db8::1:8080")会返回nil(末尾冒号被当成端口分隔符) - 监听时用
net.Listen("tcp", "[::1]:8080"),而非"::1:8080";前者明确表示IPv6通配,后者会被当作非法地址
双栈监听要显式用[::],别依赖0.0.0.0自动降级
Go的net.Listen不会自动把"0.0.0.0:8080"扩展成双栈——它只开IPv4。想让一个端口同时响应IPv4和IPv6请求,必须用IPv6通配地址[::],并确保系统启用IPv6双栈支持。
-
net.Listen("tcp", "[::]:8080")在Linux/macOS上默认启用双栈(IPV6_V6ONLY=0),Windows需手动开启 - 检查是否生效:用
ss -tln | grep :8080,看到*:8080或:::8080才表示双栈已启用;若只显示0.0.0.0:8080,说明仍为纯IPv4 - 某些容器环境(如Docker默认网络)禁用IPv6,此时
[::]监听会失败,需在docker run中加--sysctl net.ipv6.conf.all.disable_ipv6=0
net.Conn.RemoteAddr()返回的IPv6地址带Zone ID,跨主机通信时需剥离
当客户端通过链路本地地址(如fe80::1%en0)连接时,RemoteAddr().String()会返回带%后缀的完整地址。这个Zone ID只在本机有效,转发或日志记录时若不处理,会导致后续解析失败或误判为不同客户端。
- 用
ip, _ := addr.(*net.TCPAddr).IP拿到net.IP后,调用ip.To16()可得标准16字节格式,自动丢弃Zone ID - 若需保留原始字符串做调试,可用
strings.SplitN(addr.String(), "%", 2)手动切掉Zone部分 - 注意:
net.ParseIP无法解析带Zone的地址,所以任何需要二次解析的场景(如ACL匹配、DNS反查)都必须先清理Zone
UDP IPv6多播需绑定[::]且设置net.Interface,否则收不到包
IPv6多播不像IPv4那样能靠0.0.0.0兜底。UDP套接字必须显式绑定到[::],并加入对应网卡的多播组,否则内核直接丢弃入向多播包。
立即学习“go语言免费学习笔记(深入)”;
- 绑定:
net.ListenUDP("udp6", &net.UDPAddr{IP: net.ParseIP("::"), Port: 12345}),不能用nil或空UDPAddr - 加入组:
ifc, _ := net.InterfaceByName("en0"); conn.JoinGroup(ifc, &net.UDPAddr{IP: net.ParseIP("ff02::1")}),接口名必须真实存在 - 发送时目标地址也要带
[ff02::1]方括号,例如conn.WriteTo([]byte("hi"), &net.UDPAddr{IP: net.ParseIP("ff02::1"), Port: 12345})
[::]写法——这两处一旦写错,程序完全静默,连错误都不报,只能抓包确认。











