结论：用libevent搭配手写帧解析更易压住延迟和内存，尤其适合嵌入式网关、iot设备等资源受限场景；因websocket非裸tcp流，需严格校验upgrade头、sec-websocket-key/accept、掩码解包、心跳超时及bufferevent写事件管控，任一环节疏漏将导致连接秒断或解帧失败。
直接说结论：用 libevent 搭配手写帧解析，比套用 Boost.Beast 或 uWebSockets 更容易压住延迟和内存——尤其在嵌入式网关、IoT设备这类资源受限场景下。
为什么不能直接 accept() 后就 read()？
WebSocket 不是裸 TCP 流，握手后必须切换协议状态。服务端若忽略 Upgrade: websocket 头或没校验 Sec-WebSocket-Key，浏览器会静默失败，控制台只报 WebSocket connection to 'ws://...' failed，没有具体错误码。
- 必须检查 HTTP 请求头中是否存在
Upgrade且值为websocket -
Sec-WebSocket-Version必须是13（RFC 6455 唯一支持版本） -
Sec-WebSocket-Key是 base64 编码的 16 字节随机串，不能空、不能复用 - 计算
Sec-WebSocket-Accept时，必须拼接固定 GUID："258EAFA5-E914-47DA-95CA-C5AB0DC85B11"，再做 SHA-1 + base64
漏掉任意一条，连接会在 300ms 内断开，但客户端看不到原因。
客户端发来的帧为什么总是 decode 失败？
因为所有从客户端到服务端的帧都强制要求掩码（Mask == 1），而服务端回包不能掩码。如果你用 recv() 直接读原始字节却没解掩码，payload 就是乱码，opcode == 0x1 时 UTF-8 解码必然失败。
- 掩码密钥是帧头第 3–6 字节（共 4 字节），紧接在
Payload length字段之后 - 掩码操作是逐字节异或：
unmasked[i] = masked[i] ^ mask_key[i % 4] - 务必在解析
FIN和opcode后再解掩码，否则无法判断是否是分片帧（opcode == 0x0） - 不要用
std::string存二进制帧 payload，改用std::vector<uint8_t></uint8_t>，避免\0截断
心跳超时怎么设才不丢连接又不占资源？
不是越频繁越好。浏览器和多数客户端实现对 Ping 帧的响应有硬性 timeout，比如 Chrome 是 30 秒未收到 Pong 就断连；但服务端若每 5 秒发一次 Ping，在 2000+ 连接时仅心跳就吃掉可观 CPU。
- 推荐服务端设置读超时为
60s，并每45s主动发一次Ping（留 15s 余量） - 收到
Ping必须立即回Pong，不能排队等业务逻辑处理完——否则可能超时 - 用
bufferevent_set_timeouts()设置读写 timeout，别依赖event_add()手动计时器，后者在高并发下精度差、易堆积 - 注意：
Pong帧 payload 必须原样 echoPing的 payload，哪怕为空
bufferevent_write() 发不出去数据？
常见于没调用 bufferevent_enable(ev, EV_WRITE)，或者写了数据但没触发回调——因为 libevent 默认只监听读事件。更隐蔽的问题是：你调了 bufferevent_write()，但底层 socket 发送缓冲区满，EV_WRITE 事件没就绪，数据就卡在 output buffer 里不动。
- 确保在
bufferevent_socket_new()后立刻调用bufferevent_enable(ev, EV_READ | EV_WRITE) - 发送前检查
bufferevent_get_output_buffer_size(ev)，如果远大于 64KB，说明下游消费太慢，该主动断连 - 不要在
writecb回调里再调bufferevent_write()，容易递归溢出；应把待发数据暂存队列，靠EV_WRITE触发批量 flush - 关闭连接前，先调
bufferevent_disable(ev, EV_READ)，再等output buffer清空后调bufferevent_free()
最易被忽略的一点：libevent 的 bufferevent 默认使用 EV_PERSIST，但 WebSocket 连接生命周期长，writecb 若没清空 output buffer，会持续触发，最终耗尽 event loop 调度能力——必须手动控制 write 事件启停。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
