zinx的workerpoolsize不能随便调大，因为go调度器在worker数远超cpu核心数时会因频繁上下文切换拖慢吞吐；默认值10已适配多数中等负载tcp服务，建议设为runtime.numcpu()的1–2倍并压测调优。
为什么 Zinx 的 WorkerPoolSize 不能随便调大
不是线程越多越快，Go 的 goroutine 调度器在 Worker 数量远超 CPU 核心数时，反而会因频繁上下文切换拖慢整体吞吐。Zinx 默认的 WorkerPoolSize 是 10，对多数中等负载 TCP 服务已足够。
常见错误现象：pprof 显示大量 goroutine 处于 runnable 状态但 CPU 利用率不高；/debug/pprof/goroutine?debug=2 抓到成百上千个空闲 worker 在等待任务。
- 建议先设为
runtime.NumCPU()的 1–2 倍，再结合压测调整 - 如果业务逻辑含阻塞 I/O（如未加 context 的 HTTP 调用），worker 数可略增，但必须配合超时控制
- 切勿把
WorkerPoolSize和MaxConn按 1:1 设置——连接数是并发量，worker 是处理能力，二者量纲不同
sync.Pool 在 Zinx 消息处理中的真实用法
Zinx 的 MsgHandler 每次收到数据包都要解析、构造 ziface.IMessage，若每次都 new 结构体，GC 压力会随连接数线性增长。这时 sync.Pool 不是“锦上添花”，而是防止内存抖动的刚需。
容易踩的坑：直接把结构体指针存进 pool，但没重置字段，导致后续复用时携带脏数据；或者 pool 对象生命周期失控，被长期持有导致无法回收。
- pool 的
New函数必须返回已清零的对象，例如&Message{}而非new(Message) - 每次从 pool.Get() 拿出后，立刻做字段重置（如
msg.SetData(nil)、msg.SetMsgId(0)） - Zinx 中推荐在
Connection.ReadLoop入口处 Get，在消息分发完成、写回响应前 Put，确保单次请求生命周期内对象不跨阶段复用
HTTP 服务和 TCP 服务共用端口时的 http.Server 配置陷阱
很多项目想让 Zinx TCP 服务和管理接口（如 pprof、健康检查）共用一个端口，靠协议识别分流。但 Go 的 http.Server 默认不校验首字节，遇到非 HTTP 流量会卡住连接，最终触发 ReadTimeout 或堆积在 Listener.Accept 队列。
典型表现：TCP 客户端能连上但收不到任何响应；netstat -an | grep :8999 显示大量 SYN_RECV 或 ESTABLISHED 但无数据流动。
- 必须显式设置
http.Server.ReadHeaderTimeout（建议 ≤ 2s），避免非 HTTP 流量长期占着连接 - 禁用
http.Server.TLSConfig（除非真走 HTTPS），否则 TLS 握手失败会静默丢弃连接 - 更稳妥的做法是分离端口：TCP 服务用
TcpPort，HTTP 管理接口单独监听AdminPort，由反向代理或防火墙统一暴露
为什么 make([]byte, 0, MaxPacketSize) 比 make([]byte, MaxPacketSize) 更安全
Zinx 的 MaxPacketSize 是防攻击边界，但直接预分配满容量 slice，会让每个连接都独占一块固定内存。1 万个连接 × 4KB = 40MB，哪怕大部分连接空闲也照常占用——这不是泄漏，但属于隐性资源浪费。
而 make([]byte, 0, MaxPacketSize) 只申请底层数组容量，len 为 0，真正读数据时才通过 append 动态扩展。只要业务层不滥用 append 导致多次扩容，就能兼顾安全与内存效率。
- 务必配合
cap(buf) >= needed判断，避免扩容时触发新分配 - 在
Connection初始化时创建该 buffer，并复用至连接生命周期结束，不要在每次读循环里重新 make - 若使用
io.ReadFull或bufio.Reader，需确认其内部是否依赖 len > 0，否则可能读不满就返回io.ErrUnexpectedEOF
MaxConn 的匹配关系。Linux 默认单进程最多打开 1024 个 fd，而 Zinx 的每个连接至少占用 1 个 socket fd + 若干 runtime 内部 fd。不调高 ulimit -n 就直接设 MaxConn: 10000，服务会在连接数接近阈值时开始静默拒绝新连接，日志里却看不到明显报错。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
