私聊和群聊本质是消息路由逻辑差异：私聊发给targetid对应单个连接，群聊广播给除自己外所有在线用户；服务端依type字段路由，用map存连接，校验readystate后发送，避免阻塞。
私聊和群聊的本质区别，就是消息发给谁——不是功能类型，而是路由逻辑。 你不需要两套 websocket 服务，也不需要写两套连接管理代码；只要在收到消息后，决定调用 ws.send() 给谁、发几次，就完成了路由控制。
消息进来后怎么识别是私聊还是群聊
客户端必须在发送消息时明确声明意图，服务端不能猜。常见做法是约定一个 JSON 消息结构，包含 type 字段：
-
type: "group"→ 广播给除自己外所有在线用户 -
type: "private"→ 只发给targetId对应的单个连接 - （可选）
type: "system"或type: "broadcast"→ 发给所有人（含自己）
关键点：服务端不校验 targetId 是否真实存在，只查 clients.get(targetId) 是否有值且 readyState === WebSocket.OPEN。如果查不到或已断开，就静默丢弃，不要报错返回给客户端——否则容易被用于探测在线状态。
如何安全地存储和查找用户连接
用 Map 存储比对象更稳妥：const clients = new Map()，因为键可以是任意类型（比如字符串 ID），且遍历时顺序确定、无原型污染风险。
- 连接建立时，必须从 URL 查询参数或握手头里提取用户标识，例如：
const userId = new URL(request.url, `http://${request.headers.host}`).searchParams.get('userId') - 如果没传
userId，直接ws.close(4001, 'missing userId')并 return，别放进clients - 断开连接时，务必监听
ws.on('close', () => clients.delete(userId))和ws.on('error', () => clients.delete(userId))，否则内存泄漏
别用 Array.find() 查找目标连接——Map.get() 是 O(1)，而遍历数组是 O(n)，高并发下延迟明显。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
群聊广播为什么不能用 for...of + ws.send() 硬循环
看似简单，但会阻塞事件循环，尤其当在线人数多、某条消息触发大量 ws.send() 时，Node.js 主线程可能卡住几十毫秒，导致新连接握手延迟、心跳超时、甚至整个服务假死。
- 正确做法：用
Promise.allSettled()包裹所有ws.send()调用，让它们并发执行（注意：不是并行，是异步调度） - 更稳的做法：把待发消息推入队列，用
setImmediate()或process.nextTick()分批发送，避免单次处理超过 50 个连接 - 永远检查
ws.readyState === WebSocket.OPEN再 send，否则抛InvalidStateError，且不会自动重试
示例片段：
const promises = [];
for (const [id, ws] of clients) {
if (id !== senderId && ws.readyState === WebSocket.OPEN) {
promises.push(ws.send(JSON.stringify(msg)));
}
}
Promise.allSettled(promises); // 不因某个失败中断其余发送
私聊消息收不到？先盯住这三件事
90% 的私聊失败不是逻辑错，而是基础设施没对齐：
- 前端连的是
ws://localhost:8080?userId=alice，后端却从request.headers.cookie里取 ID —— 路径参数没读对 - 前端发
{ type: "private", targetId: "bob", content: "hi" }，但后端存的 key 是"user_bob"，而没做前缀统一，clients.get("bob")返回undefined - 目标用户连接已断开，但服务端没及时清理
clients，仍尝试 send → 报错但没 catch → 整个 message 处理流程中断
最有效的排查方式：在 ws.on('message') 开头加一行 console.log('RECV:', message.toString())，再在发送前加 console.log('SEND TO:', targetId, 'FOUND?', !!targetWs) —— 不要依赖“应该在线”，要看实际查出来是什么。
