SignalR群聊通过Groups.AddToGroupAsync/RemoveFromGroupAsync实现分组通信，需校验群组名、及时移除旧组；按用户发送需设置UserIdentifier并用Clients.User()；常见问题多因连接生命周期或上下文误用导致。
SignalR 群聊怎么建：Hub 里用 AddToGroupAsync 和 RemoveFromGroupAsync
群聊本质是“把多个连接加入同一个逻辑分组”，不是靠客户端硬编码房间名或轮询。SignalR 的 Groups 是服务端维护的轻量级映射，不自动持久化，也不跨服务器（除非配了 Redis 背板）。
实操建议：
- 客户端连接后，立刻在
OnConnectedAsync里调用await Groups.AddToGroupAsync(Context.ConnectionId, "lobby")，把用户加进默认群组 - 换房间时，先
await Groups.RemoveFromGroupAsync(Context.ConnectionId, "old-room")，再加新群组——漏掉移除会导致重复收消息 - 群组名别用用户输入直接拼接，比如
Groups.AddToGroupAsync(..., userInput)，可能引发注入或冲突；建议用白名单校验或哈希处理 -
SendToGroupAsync("room1", ...)只发给当前在线且在该组的连接，离线用户不会收到——这不是 Bug，是设计如此
C# 怎么向指定用户发消息：用 Client 或 User 这两个上下文
SignalR 没有“全局发给某 ID 用户”的快捷 API，必须依赖 IHubContext 或 Hub 内部的 Clients 属性。关键区别在于：Clients.Client(connectionId) 发给单个连接，Clients.User(userId) 发给所有属于该用户的连接（比如用户在手机和电脑同时在线）。
实操建议：
- 要按用户发，必须在连接建立时设置
Context.UserIdentifier，比如在ConfigureServices里配好AddSignalR().AddJsonProtocol(...)，并确保认证中间件已运行，否则Clients.User(...)总是空 - 用
Clients.Client("abc123").SendAsync("ReceiveMessage", ...)最精准，但需要你存着每个用户的ConnectionId——它每次重连都会变，不能当长期 ID 存 - 别在 Hub 外直接 new 一个 Hub 实例去发消息，那没用；必须通过
IHubContext<chathub></chathub>注入使用 - 如果用了 JWT 认证，
UserIdentifier默认取的是sub声明，不是用户名；想改就重写IUserIdProvider
常见错误现象：消息发出去了但对方收不到
这不是网络问题，90% 出在连接生命周期或上下文误用上。
典型表现和排查点：
- 前端控制台报
Failed to invoke 'SendMessage' due to an error on the server. Error: Connection disconnected before invocation result was returned.——说明 Hub 方法执行太久（比如同步 IO、死锁），或用了async void；Hub 方法必须返回Task - 用户 A 发消息，B 收不到，但 C 能收到 ——检查 B 是否真在目标群组里，用
await Groups.GetConnectionsForGroupAsync("room1")在服务端查一下实际成员列表 - 用
Clients.All.SendAsync(...)能收到，但Clients.User("u123").SendAsync(...)没反应 ——确认Context.UserIdentifier已正确设值，且前后端 token 一致；可临时加日志输出Context.UserIdentifier看是否为空 - 发消息后页面卡住或 CPU 飙高 ——可能是前端回调函数里写了死循环，或反复调用
connection.start()导致多个连接叠加
Hub 方法参数和序列化要注意什么
SignalR 默认用 System.Text.Json，不支持 DateTimeOffset 的某些格式、不处理循环引用、对 Dictionary<string object></string> 序列化行为和 Newtonsoft.Json 不同。
容易踩的坑：
- 传自定义类时，字段必须是 public，且不能有无参构造函数以外的构造函数（否则反序列化失败）
- 别传
Task类型参数，会直接抛NotSupportedException - 大对象（比如 >1MB 的 byte[]）可能触发默认 32KB 消息限制，需在
AddSignalR里配置MaximumReceiveMessageSize - Hub 方法签名里不要用
ref或out参数，SignalR 不支持
最麻烦的其实是连接状态管理——SignalR 不保证连接不丢，也不自动重连语义；用户切后台、休眠、弱网时，OnDisconnectedAsync 可能延迟数秒甚至不触发。别指望靠它实时清理群组成员，得结合心跳或超时淘汰机制。
