Go netpoll 不提供异步广播引擎,仅支持单连接I/O事件;广播需业务层管理连接集合、并发写、超时控制及错误清理。
go 原生 netpoll 不提供“异步广播引擎”这种开箱即用的组件,它只负责单连接 i/o 事件的挂起与唤醒;所谓“广播”,必须由业务层自己组织连接集合、触发并发写,并处理写失败、连接断开、背压等现实问题。
netpoll 本身不支持 broadcast 或 multi-write
Go 的 netpoller 是 per-connection 的:每个 net.Conn 对应一个 pollDesc,注册的是该 fd 上的可读/可写事件。它不会、也不能自动把一次数据发给多个 conn——这不属于 I/O 多路复用层的职责。
- 你调用
conn.Write(),底层只会对这个 conn 的 fd 调用write(2)或注册EPOLLOUT;写完或阻塞后,仅影响当前 goroutine 状态 - 没有
net.Broadcaster、poller.Broadcast()或类似 API;标准库中不存在任何广播语义的封装 - 试图在
netpoll_epoll.go里找广播逻辑,只会看到单 fd 的epoll_ctl和epoll_wait调用
真正能跑起来的广播,得靠你管住连接生命周期
所谓“基于 netpoll 的广播引擎”,实际是利用 Go 运行时对每个连接的高效等待能力,再叠加一层连接管理。关键不在 epoll,而在你怎么持有、遍历、安全写这些 conn。
- 必须用线程安全的结构存活跃连接,比如
sync.Map[*net.TCPConn, struct{}]或带锁的 slice;不能直接用 map 并发读写 - 每次广播前要检查 conn 是否还存活:
conn.RemoteAddr()不报错 ≠ 可写;需配合SetWriteDeadline+ 忽略io.ErrClosed和syscall.EPIPE等错误 - 不要同步阻塞地遍历写:1000 个连接挨个
conn.Write()会卡住调度器;应启动 goroutine 并发写,但要限制并发数(如用semaphore控制 64 路并行) - 写失败的连接必须及时清理,否则内存泄漏+无效轮询;建议在
Write返回 error 后调用conn.Close()并从集合中删除
conn.Write() 卡住?大概率不是 netpoll 失效,而是你没设超时
看起来“广播卡住”,往往是因为某几个连接长期不可写,而你的代码没做超时控制,导致 goroutine 挂在 conn.Write() 上动不了——但它其实正被 netpoll 正常 park 着,只是没人唤醒。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 务必为每个 conn 设置写超时:
conn.SetWriteDeadline(time.Now().Add(5 * time.Second)) - 忽略
net.ErrWriteTimeout和io.EOF,它们代表连接已失效,不是程序 bug - 用
runtime/pprof.Lookup("goroutine").WriteTo(os.Stdout, 1)查看是否大量 goroutine 停在internal/poll.(*FD).Write—— 如果状态是IO wait,说明 netpoll 正常;如果是running,那才是真卡死 - 不要依赖
conn.Read()保活:客户端静默时,服务端不收数据就永远等下去;需开启SetKeepAlive或应用层心跳
最易被忽略的一点:netpoll 的高效,只作用于「单连接 I/O 等待」;一旦进入「多连接协调」,所有复杂度立刻回归业务层——连接怎么增删、写失败如何降级、消息要不要排队、不同客户端协议差异怎么兼容,这些 netpoll 一概不管。你写的不是引擎,是一套带容错的连接广播循环。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










