websocket需精细控制通信链路：esp32/8266必须用websocketsserver库（≥2.3.6），禁用wificlient裸写；json解析须用deserializejson()直读缓冲区；需主动心跳检测假在线；控制指令用text、传感器数据用binary分层传输；所有消息加seq字段保障有序可靠。
WebSocket不是万能胶，它只负责把字节从A端送到B端——设备能不能响、数据对不对、断了怎么续，全靠你对硬件通信链路的控制粒度。
ESP32/ESP8266上WebSocket服务器必须用WebSocketsServer库，别碰WiFiClient裸写
有人试图用WiFiClient手动解析WebSocket握手帧和数据帧，结果卡在mask key校验或ping/pong超时上三天。这不是练内功，是给自己挖坑。官方WebSocketsServer（Markus Sattler版）已封装完整协议逻辑，包括：自动处理Sec-WebSocket-Accept头、帧解包/掩码、心跳保活、连接池管理。但注意两点：
- 必须用
2.3.6及以上版本——早期2.2.x存在连接数超过5后内存泄漏，设备运行24小时必宕 -
WebSocketsServer默认不启用SSL，若前端用wss://访问，服务端必须配合AsyncTCP+AsyncSSL，否则浏览器直接拒绝连接 - 端口别硬写
80——某些路由器会拦截或重定向，实测81或8080更稳
收到WStype_TEXT消息后，别直接String(payload)解析JSON
ESP芯片RAM紧张，String类动态分配+隐式拷贝极易触发碎片化崩溃。尤其当网页发来带空格或换行的JSON（比如开发者工具里手敲测试），payload末尾可能含不可见字符，String构造失败返回空串，后续parseObject()直接跳过不报错。
正确做法是用ArduinoJson的deserializeJson()直读缓冲区：
DynamicJsonDocument doc(512);
DeserializationError err = deserializeJson(doc, payload, length);
if (err) {
Serial.printf("JSON parse error: %s\n", err.c_str());
return;
}
const char* cmd = doc["cmd"] | "";
if (strcmp(cmd, "led") == 0) {
digitalWrite(LED_PIN, doc["value"] | 0 ? HIGH : LOW);
}
关键点：
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
-
DynamicJsonDocument大小按实际消息预估，512字节够大多数控制指令；传感器上报建议1024+ -
payload是uint8_t*，length是真实字节数，必须传入，不能依赖strlen() - 用
doc["key"] | default安全取值，避免字段缺失导致as<t>()</t>崩溃
设备离线时WebSocket连接不会立刻断开，得靠WStype_PING和心跳检测
Wi-Fi信号波动、路由器休眠、手机切后台，都会让TCP连接“假在线”——服务端收不到DISCONNECTED事件，仍向设备发指令，数据石沉大海。仅靠onClose监听远远不够。
必须主动加心跳机制：
- 在
webSocketEvent中捕获WStype_PING，立即回PONG（库已自动处理，无需代码） - 在
loop()里每10秒调用webSocket.ping()，强制触发PONG响应 - 维护每个连接的最后
PONG时间戳，若超30秒未更新，webSocket.disconnect(num)主动清理 - 前端网页也得发心跳（如每15秒
socket.send('{"type":"ping"}')），和服务端双向确认
控制指令和传感器数据混在一个WebSocket连接里，消息类型必须严格区分
别图省事全用TEXT帧塞JSON。高频传感器数据（如DHT22每2秒上报）和低频控制指令（用户点击开关）混传，会导致指令被数据流淹没，或解析延迟突增。
推荐分层设计：
- 控制指令走
WStype_TEXT，结构固定：{"type":"control","id":"relay1","op":"on"} - 传感器数据走
WStype_BINARY，用uint8_t数组打包：[temp_h, temp_l, humi_h, humi_l, batt]（5字节），体积比JSON小80%，解析零开销 - 服务端用
webSocket.sendBIN()推二进制，前端用event.data instanceof ArrayBuffer区分处理 - 所有消息加
seq字段，前端可丢弃重复或乱序帧
真正难的从来不是连上WebSocket，而是让每一次sendTXT()都确信设备收到了，每一次digitalWrite()都同步反映在网页UI上——这需要你在字节级控制握手、心跳、分帧和错误重试，而不是依赖库的默认行为。
