Golang原生Websocket扩展包性能对比选择-Golang-PHP中文网

nhooyr.io/websocket更优：单机10万+连接时，其零拷贝设计使单连接内存降至0.5–1kb，gc频率降一个数量级；gorilla/websocket默认每连接2–3kb缓冲区，适合几十至几千连接的内部系统，调试更便利。

golang原生websocket扩展包性能对比选择

gorilla/websocket 还是 nhooyr.io/websocket？看连接规模和 GC 压力

如果单机要撑住 10 万+ 并发连接，nhooyr.io/websocket 几乎总是更优；若只是内部系统、几十到几千连接，gorilla/websocket 的成熟度和调试便利性反而更省心。

根本差异不在“能不能用”，而在内存分配模式：gorilla/websocket 默认为每个连接分配独立的读写缓冲区（约 2–3KB），而 nhooyr.io/websocket 使用零拷贝 + 复用 io.ReadWriter，实测单连接内存开销压到 0.5–1KB。GC 频率直接下降一个数量级，这对长连接服务很关键。

gorilla/websocket 的 Upgrader 支持细粒度配置（如 CheckOrigin、Subprotocols），适合需要协议协商或复杂鉴权的场景
nhooyr.io/websocket 的 AcceptOptions 更精简，但强制要求显式传入 context.Context，对超时控制更自然
两者都完整通过 Autobahn Test Suite，RFC 6455 兼容性无差别

gobwas/ws 适合什么人用？别盲目追性能

gobwas/ws 是给真正卡在百万连接、内存红线边缘的人准备的——它绕过 Go 标准库 net/http，直接操作底层连接，牺牲了 HTTP 中间件、日志、路由集成等便利性。

典型误用场景：在 Echo 或 Gin 里硬塞 gobwas/ws 升级逻辑。它不兼容 http.Handler 接口，必须自己处理 TLS、HTTP 头解析、upgrade handshake 等细节。除非你已经在 epoll / kqueue 层做深度优化，否则收益远低于维护成本。

升级调用是 ws.UpgradeHTTP(r, w)，返回裸 Conn，没有封装好的 ReadMessage/WriteMessage
没有内置 ping/pong 心跳，需手动实现 ControlFrame 处理
社区更新慢，文档稀疏，出问题基本靠读源码（主要是 conn.go 和 frame.go）

压缩支持不是“开个开关”就完事

启用 permessage-deflate（RFC 7692）后，吞吐量可能不升反降——尤其当消息平均长度节省的带宽。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

gorilla/websocket 和 nhooyr.io/websocket 都支持，但行为不同：gorilla 默认关闭，需显式设 EnableCompression: true 并在 Upgrader 中配 CompressionLevel；nhooyr 默认开启，但只对 > 1KB 消息自动压缩，更合理。

别在 gorilla 里全局打开压缩，先用 pprof 看 CPU 是否被 compress/flate 吃掉
nhooyr 的压缩可关闭：&websocket.AcceptOptions{Compress: false}
二者都不支持服务端强制要求客户端压缩（即 no context takeover），这是部分 CDN 或代理的兼容盲点

并发写安全：最容易被忽略的 panic 来源

WebSocket 连接默认**不允许多 goroutine 并发调用 WriteMessage 或 WriteJSON**——无论用哪个库，都会 panic 或静默丢消息。

gorilla/websocket 提供 conn.WriteMutex 和 conn.SetWriteDeadline，但得自己加锁；nhooyr.io/websocket 直接暴露 conn.Write 底层方法，更灵活但也更易出错。

通用解法：用 chan []byte 做单写 goroutine，所有写请求投递到该 channel
gorilla 的 conn.WriteMessage 内部已加锁，但仅限该方法；混用 WriteJSON 和 WriteMessage 仍需外部同步
nhooyr 的 conn.Send 是线程安全的，但 conn.Ping 不是，心跳和业务写不能共用同一连接实例