SuperAPI AI 工具集

websocket-engineer

编程与开发

查看项目

更新于 10-16 23:14

技能介绍

用途

WebSocket Engineer 用于构建实时通信系统,基于 WebSocket 或 Socket.IO 实现双向消息传递,并支持基于 Redis 的水平扩展、在线状态(presence)跟踪与房间(room)管理。

主要能力

该技能围绕一套核心工作流展开:

  1. 分析需求——识别连接规模、消息量与延迟需求。
  2. 设计架构——规划集群、发布/订阅、状态管理与故障转移。
  3. 实现——构建带认证、房间与事件的 WebSocket 服务器。
  4. 本地验证——在扩展前测试连接处理、认证与房间行为(例如 npx wscat -c ws://localhost:3000),确认缺失或无效令牌时认证被拒绝、房间加入/离开事件以及消息投递。
  5. 扩展——在启用适配器前验证 Redis 连接与发布/订阅往返;配置粘性会话并通过多实例测试连接确认;设置负载均衡。
  6. 监控——跟踪连接数、延迟、吞吐量与错误率;为连接数激增和错误率阈值添加告警。

技能附带按上下文加载的参考指南,涵盖:协议(WebSocket 握手、帧、ping/pong、关闭码)、扩展(水平扩展、Redis 发布/订阅、粘性会话)、模式(房间、命名空间、广播、确认)、安全(认证、授权、限流、CORS)、替代方案(SSE、长轮询、何时选择 WebSocket)。

使用方式

技能提供代码示例,包括:

  • 服务端设置:使用 Socket.IO 配合 JWT 认证中间件、Redis 适配器实现水平扩展、在线状态记录、房间加入与消息广播、断开连接清理。
  • 客户端重连:使用 socket.io-client 配置指数退避重连(含抖动),在断线期间排队消息并在重连后刷新队列。

实现 WebSocket 功能时,输出模板建议提供:服务端设置(Socket.IO/ws 配置)、事件处理器(连接、消息、断开)、客户端库(连接、事件、重连)以及扩展策略的简要说明。

适用场景

适用于需要实时双向通信的系统,例如需要房间管理、在线状态跟踪、跨多实例水平扩展的实时应用。

限制与约束

必须遵守的约束包括:负载均衡使用粘性会话(WebSocket 连接是有状态的,请求必须路由到同一服务器实例);实现心跳/ping-pong 检测死连接(仅靠 TCP keepalive 不够);使用房间/命名空间进行消息范围划分而非在应用逻辑中过滤;在断线窗口排队消息以避免静默数据丢失;水平扩展前规划每实例连接上限。 禁止事项包括:在没有集群策略的情况下将大量状态存储在内存中(应使用 Redis 或外部存储);在没有显式升级处理的情况下在同一端口混用 WebSocket 与 HTTP;忘记处理连接清理(在线状态记录、房间成员关系、进行中的定时器);在生产前跳过负载测试——连接数激增的行为与 HTTP 流量激增不同。

知识参考

涉及 Socket.IO、ws、uWebSockets.js、Redis 适配器、粘性会话、nginx WebSocket 代理、WebSocket 上的 JWT、房间/命名空间、确认、二进制数据、压缩、心跳、背压、水平 Pod 自动扩缩容。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明