Groups.AddToGroupAsync必须由客户端显式调用，服务端不能代劳；它是将当前连接加入内存命名桶，非持久化操作，组名区分大小写，且仅在Hub内可用。
Groups.AddToGroupAsync 必须由客户端显式触发，服务端不能“代劳”
SignalR 的组不是数据库表，AddToGroupAsync 不是“注册用户进房间”，而是“把当前连接加入内存中的一个命名桶”。这个动作必须发生在客户端已建立连接之后，且由 Hub 方法（如 AddToGroup）被调用时执行——你不能在 OnConnectedAsync 里直接硬编码加组，除非你有可靠的身份上下文（比如 JWT 解出 userId 后查数据库拿到其默认房间）。
常见错误现象：
– 客户端没调用 hub.invoke("AddToGroup", "lobby")，服务端却直接 Clients.Group("lobby").SendAsync(...) → 消息静默丢失，无异常、无日志。
– 在 OnConnectedAsync 中尝试用 Context.UserIdentifier 加组，但未启用认证或 Claim 缺失 → Context.UserIdentifier 为空，加组失败。
- 加组前务必确认
Context.UserIdentifier非空，或从客户端传入可信的groupName - 组名区分大小写，
"Lobby"和"lobby"是两个组 - 不要在中间件或过滤器里操作 Groups ——
Groups只在 Hub 实例中可用
Clients.Group(groupName).SendAsync 是纯内存广播，不跨服务器也不持久
Clients.Group(groupName).SendAsync 发送的是即时快照：只触达当前所有在线且已加入该组的连接。它不查数据库、不走 Redis、不等重连恢复 —— 连接断开一秒，就彻底掉出组；服务器重启一次，所有组全部清空。
使用场景：
– 内网小规模聊天室（– 临时协作白板、会议共享状态（会后即弃）
– 不适合：需离线消息、历史回溯、高可用集群的生产环境
- 若部署多台服务器，必须切换到
Azure SignalR 服务，否则组消息无法路由到其他节点 - 别依赖
Groups.Count()或类似方法 —— SignalR 根本不提供组成员数 API - 组名建议带业务前缀，如
"room_{id}"或"project_{slug}"，避免和用户 ID 冲突
退出组要主动调用 RemoveFromGroupAsync，断连不会自动清理
SignalR 不会在连接断开时自动调用 RemoveFromGroupAsync。这意味着如果用户关闭浏览器、网络中断、或 App 杀后台，其 ConnectionId 仍滞留在组内 —— 直到下次心跳超时（默认 30 秒）或服务器 GC 清理弱引用。这段时间发往该组的消息，会因连接已失效而悄悄失败（客户端收不到，服务端也无报错）。
容易踩的坑：
– 仅靠 OnDisconnectedAsync 做清理，但没同步调用 Groups.RemoveFromGroupAsync → 组“脏数据”堆积
– 把退出逻辑全押在前端监听页面卸载事件（beforeunload），但移动端、强制杀进程时根本捕获不到
- 在
OnDisconnectedAsync中务必补上await Groups.RemoveFromGroupAsync(Context.ConnectionId, groupName) - 若用户可能同时多端登录（如手机+PC），不要在断连时删所有组 —— 应只删当前
Context.ConnectionId所在的组 - 考虑加一层轻量心跳（如每 15 秒客户端 ping 一次），服务端超时未收到则主动踢出组
群组权限校验得自己做，SignalR 不管你是谁
AddToGroupAsync 不验证权限，Clients.Group(...) 也不拦截未授权访问。如果只是前端传个 "admin" 就让你进了管理组，那任何人都能伪造请求混进去。
真实约束点在两处：
– 加组前：检查 Context.User 是否有 "Room:Join" 声明，或查 DB 确认用户属于该房间
– 发消息时：即使进了组，也要在 SendMessage 方法里再次校验发送者/接收者权限（比如禁止游客发图文）
- 别用前端传来的
groupName直接入库或拼 SQL —— 防注入，先白名单校验（如Regex.IsMatch(groupName, @"^room_\d+$")） - 组名不要暴露敏感信息，如
"user_12345"易被枚举，改用"g_{guid}"+ 映射表 - 若需严格权限，把组绑定到策略（Policy），用
[Authorize(Policy = "InRoomPolicy")]装饰 Hub 方法
最常被忽略的一点：组名生命周期和服务端进程完全绑定。你本地调试时加的 "test" 组，上线后第一次发布重启，它就没了 —— 别指望它像数据库表一样“一直都在”。需要长期存在的分组关系，必须落地存储，并在每次重连时重新加载加入。
