“address family not supported by protocol”本质是ipv6 socket创建失败，主因是系统禁用ipv6（如ipv6.disable=1）而go默认监听[::]:端口触发af_inet6系统调用返回eafnosupport，修复应显式指定"0.0.0.0:端口"而非修改内核参数。
go程序报“address family not supported by protocol”本质是ipv6 socket创建失败
这个错误不是go代码写错了，而是运行时尝试用af_inet6调用socket()系统调用，但内核返回了eafnosupport——说明当前环境不支持ipv6地址族。最常见场景是系统启动时加了ipv6.disable=1，或手动设了/proc/sys/net/ipv6/conf/all/disable_ipv6 = 1，而go的http.listenandserve("", handler)、net.listen("tcp", ":8080")等默认行为会 fallback 到[::]:端口，触发失败。
不要改内核参数，优先在代码/配置里显式指定IPv4监听地址
改内核（比如删ipv6.disable=1或临时sysctl -w net.ipv6.conf.all.disable_ipv6=0）能绕过问题，但不推荐：它可能破坏安全策略、影响其他服务，且容器或受限环境根本不可行。真正稳定的做法是让程序自己放弃IPv6探测路径：
-
http.ListenAndServe(":8080", h)→ 改成http.ListenAndServe("0.0.0.0:8080", h) -
net.Listen("tcp", ":3000")→ 改成net.Listen("tcp", "0.0.0.0:3000") - 用
gin时，router.Run()→ 改成router.Run("0.0.0.0:8080") - 避免在任何地方写
[::]、::1、[::1]这类字符串作为监听地址
容器化部署时额外注意Dockerfile和运行时配置
即使代码改对了，容器里还可能因基础镜像或启动方式引入隐式IPv6依赖：
- Dockerfile中若用
EXPOSE 8080但没指定协议，某些旧版dockerd会默认绑定[::]:8080；确保CMD里传的是"0.0.0.0:8080"而非":8080" - 使用
docker run -p 8080:8080时，宿主机若禁用IPv6，docker daemon自身可能报类似错——此时需检查dockerd配置是否含"ipv6": true，有则删掉 - Alpine镜像默认不加载IPv6模块，
apk add --no-cache iptables之类操作可能意外触发IPv6初始化失败，导致后续Go监听出错；保持最小化安装
验证是否真由IPv6引起，别被表象误导
执行cat /proc/sys/net/ipv6/conf/all/disable_ipv6返回1只是强提示，不是唯一依据。有些情况看似IPv6问题，实为其他：
- 如果错误出现在
sendto/recvfrom调用（非监听阶段），检查sockaddr结构体的sin_family字段是否被误设为AF_UNSPEC或未初始化 - Android模拟器连本机服务报同错，往往是因为用了
127.0.0.1而非10.0.2.2，跟系统IPv6开关无关 - 第三方库（如某些gRPC健康检查组件）内部硬编码
[::1]，需查其文档或源码确认是否可配置监听地址
真正关键的点在于：错误发生在socket创建阶段，就只跟地址族（AF_INET vs AF_INET6）和内核支持度有关；一旦监听成功，后续通信层的问题不会抛这个错。 所以排查顺序永远是：看监听地址 → 查系统IPv6状态 → 检查调用栈是否来自net包底层 → 排除其他socket用法干扰。
