Socket.IO自动重连需协同配置timeout与reconnectionAttempts：timeout设为5000ms（轻量应用）或10000ms（企业级），对应reconnectionAttempts为3或5，避免因单次超时过短导致重试未生效；必须监听connect_error和reconnect_failed事件以精准诊断并更新UI状态。
Socket.IO 自动重连不是开个 reconnection: true 就完事的——多数连接异常、无限重试、UI卡顿或消息丢失，都源于参数组合失当或事件监听缺失。
reconnectionAttempts 和 timeout 怎么配才不瞎试？
这两个值必须协同设置，否则 reconnectionAttempts 可能根本没机会触发。
-
timeout是单次连接尝试的“生死线”：它控制客户端等待服务器响应open包的最大毫秒数。若设为2000（2秒），但服务器启动慢或网络延迟高，每次都会超时失败，reconnectionAttempts就变成“还没开始就结束” -
reconnectionAttempts是总尝试次数，但它只在每次连接尝试返回明确失败（如ECONNREFUSED）或timeout触发后才递减；若网络完全中断（如飞行模式），底层 TCP 会先等更久，此时timeout反而可能被绕过 - 推荐组合：
timeout: 5000+reconnectionAttempts: 3（轻量应用），或timeout: 10000+reconnectionAttempts: 5（内网/企业级服务）
reconnectionDelay 和 reconnectionDelayMax 的抖动陷阱
Socket.IO 默认用指数退避 + 随机抖动防雪崩，但 randomizationFactor: 0.5（默认值）意味着实际重连间隔会在 [delay, delay × (1 + randomizationFactor)] 范围内浮动。如果你没关抖动，却在日志里看到“第1次等1s、第2次等1.4s、第3次等2.1s”，别慌——这是设计使然，不是 bug。
- 不要把
reconnectionDelay设为 0：某些版本（尤其是 v3.x）会卡死在 0 延迟重试，耗尽 CPU - 避免
reconnectionDelayMax过小：比如设成2000，但reconnectionDelay是1000，那第3次重连就直接顶到上限，失去退避意义 - 真要“固定间隔”，得显式设
randomizationFactor: 0，但仅限测试环境——线上并发重连时，所有客户端同步撞服务器，容易触发限流
connect_error 和 reconnect_failed 监听为什么不能少？
不监听这两个事件，等于蒙眼开车：你既不知道断在哪一环，也无法向用户反馈或降级 UI。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
-
connect_error触发时机早于重连启动，参数err里有真实错误码（如"xhr poll error"、"websocket error"、"timeout"），可据此区分是 DNS 失败、SSL 证书错，还是 CORS 拒绝 -
reconnect_failed是最终判决书——它只在reconnectionAttempts耗尽后触发，此时应冻结发送按钮、显示“离线中”，并停止轮询业务接口 - 漏掉
reconnect_attempt会导致 UI 状态不同步：比如用户看到“正在重连…”动画，但实际已放弃，体验断裂
disconnect(true) 后重连失效？那是你没理解“销毁”语义
socket.disconnect(true) 不是“断开连接”，而是“清空实例”。调用后，该 socket 对象内部状态全被归零，包括重连配置、事件监听器、缓存的 sid ——它已经不是原来的 socket 了。
- 想临时断开再自动恢复？用
socket.disconnect()（无参），之后调用socket.connect()即可续上 - 想彻底弃用并释放内存？用
socket.disconnect(true)，但别指望它还能重连；后续必须const newSocket = io(...)新建实例 - 常见误操作：在
reconnect_failed里调socket.disconnect(true)，再试图socket.connect()——这行不通，connect()方法此时已不可用
最易被忽略的点：重连成功后，socket.id 通常已变，但旧的事件监听器（比如 socket.on('message', ...)）仍存在。如果初始化时没做去重绑定，重连后同一事件会被执行多次。务必在 connect 回调里清理再注册，或用 socket.off('message').on('message', ...) 显式控制。
