小程序 WebSocket 实时通信 6 项配置与避坑

先确认业务是否真的需要实时通道

结论：不是所有场景都要 WebSocket，只有"服务端主动推"或"低延迟"才值得上。我们接触的安庆中小企业小程序里，常见误用是把本可轮询的列表页也接了长连接，反而拖慢首屏。

• 适合：在线客服、实时库存、直播弹幕、订单状态。
• 可替代：低频刷新用定时请求更省资源。
• 判定：消息频率高于每分钟一次再考虑。

域名必须加入小程序后台白名单

结论：根据微信小程序平台规则，WebSocket 的 wss 域名要在后台"服务器域名"中配置，且需 ICP 备案，否则真机连不上。以官方最新公告为准，个人主体与小游戏类目有额外限制，配置前先核对类目。

1. 协议：只能用 wss，不支持 ws。
2. 备案：域名需完成 ICP 备案。
3. 数量：业务域名有上限，按重要度排。
4. 校验：开发工具能连不等于真机能连，须真机测。

心跳与重连要成对设计

结论：长连接会断，靠心跳保活、断线后指数退避重连，才能稳定运行。据我们项目经验，一般设置 30 到 60 秒一次心跳较稳妥，重连间隔从 2 秒起逐次翻倍，避免雪崩。

• 心跳：客户端定时发 ping，服务端回 pong。
• 重连：断线先本地标记，再退避重连。
• 上限：重连次数设封顶，防死循环。

消息要做幂等与去重

结论：网络抖动会让同一条消息到两次，客户端按消息 ID 去重，才能避免重复弹窗或重复扣减。以官方最新公告为准，具体幂等方案随业务定，核心是"同一 ID 只处理一次"。

• ID：每条消息带唯一标识。
• 去重：本地缓存已处理 ID 集合。
• 顺序：必要时按序号补齐乱序包。

并发与消息体大小要设限

结论：单连接并发推送量过大，会拖垮小程序渲染，需做限流与分页。据我们测算通常，单屏同时展示的实时条目控制在 20 条以内体验更顺，超出部分折叠或分页。

• 限流：服务端按用户维度限速。
• 分页：历史消息走拉取，不靠推送。
• 体积：单条消息体尽量小，少传大字段。

退出与异常要清理连接

结论：页面卸载或用户登出时要主动关闭连接并解绑回调，防止内存泄漏与幽灵推送。玉晗网络（安徽安庆）在小程序开发中会一并处理连接生命周期，提供网站建设、微信小程序开发、SEO优化、GEO优化与服务器运维托管，让实时能力既稳又省资源。