Go启动报“protocol not supported”错误主因是系统禁用IPv6（/proc/sys/net/ipv6/conf/all/disable_ipv6=1）而代码或框架隐式尝试绑定[::]:端口；修复方式为显式使用"0.0.0.0:端口"替代":端口"或""，强制走IPv4路径。
Go 启动报 “protocol not supported” 错误，基本不是 Go 本身的问题，而是底层 socket 创建时传入了不被系统支持的地址族（AF）或协议栈配置冲突 —— 最常见于 IPv6 禁用环境下仍尝试绑定 [::] 或 ::1。
为什么 http.ListenAndServe(":8080", h) 会触发 protocol not supported
Go 的 net/http 在监听空地址（""）或仅端口（:8080）时，内部会 fallback 到 IPv6 wildcards：[::]:8080。一旦系统禁用 IPv6（如 /proc/sys/net/ipv6/conf/all/disable_ipv6 值为 1），socket(AF_INET6, ...) 系统调用直接返回 EAFNOSUPPORT，Go 将其转为 “protocol not supported” 或更常见的 “Address family not supported by protocol”。
- 即使代码没写
[::]，gin.Default().Run(":8080")、echo.Start(":8080")等框架默认行为同样触发该路径 -
curl http://localhost:8080能通 ≠ 监听成功：可能只是碰巧绑在了 IPv4 回环（如果系统还允许 AF_INET fallback），但不可靠 - 错误通常出现在容器（Alpine）、嵌入式 Linux、或手动关闭 IPv6 的服务器上
如何快速确认是 IPv6 协议栈问题
先验证系统 IPv6 状态：
cat /proc/sys/net/ipv6/conf/all/disable_ipv6
若输出为 1，即已禁用；再试运行一个最小复现：
go run -e 'package main; import "net/http"; func main() { http.ListenAndServe("[::]:8080", nil) }'
大概率立即报错 listen tcp [::]:8080: protocol not supported。
- 不要依赖
ifconfig或ip a显示是否有lo上的inet6—— 内核模块可能加载但协议栈被 runtime 禁用 -
strace -e trace=socket go run ...可看到实际失败的socket(AF_INET6, ...)调用 - 注意区分：此错误和 TLS 协议不支持（如
tls: failed to find certificate PEM data）无关
修复方式：显式指定 IPv4 地址族
绕过 Go 的自动 fallback 逻辑，强制使用 IPv4 字面量：
- 把
http.ListenAndServe(":8080", h)改成http.ListenAndServe("0.0.0.0:8080", h) - 若用
net.Listen("tcp", ":8080")，改为net.Listen("tcp", "0.0.0.0:8080") - 框架中：gin 用
r.Run("0.0.0.0:8080")，fiber 用app.Listen("0.0.0.0:3000") - 绝对避免在监听地址中出现
[::]、::1、[::1]等 IPv6 格式字符串
改完立刻生效，无需重启系统、无需修改内核参数、也不需要重装 Go。
容易被忽略的间接来源
有些错误看似是 “protocol not supported”，实则来自依赖库的隐式行为：
- 某些中间件或日志库在初始化时尝试监听
[::1]:xxxx做健康检查（比如 Prometheus 的http.Handle("/metrics", ...)配合自建 server） - 测试代码里用了
httptest.NewUnstartedServer但未显式设置Listener，导致启动时 fallback 到 IPv6 - Docker 容器中
net.ipv6.conf.all.disable_ipv6=1是默认行为（尤其在 distroless 或 scratch 镜像中）
真正麻烦的不是改一行代码，而是排查时容易卡在“明明没写 IPv6，怎么就崩了”——盯住所有监听入口，包括你没写的那部分。
