SignalR是.NET下实现Web实时通信的成熟方案，自动选择最优传输方式并提供简洁API。服务端通过继承Hub类处理消息广播、单播与组播，客户端通过JS库连接并监听事件，支持重连机制与生命周期管理，结合认证授权和异步非阻塞设计，可构建高效可靠的实时应用。
SignalR 是 .NET 平台下实现 Web 实时双向通信的成熟方案，不用手动处理长轮询、WebSocket 兼容或连接管理——它自动选择最优传输方式，并提供简洁的 API。
服务端：快速搭建 Hub
在 ASP.NET Core 项目中安装 Microsoft.AspNetCore.SignalR 包后，新建一个继承 Hub 的类，比如 ChatHub：
- Hub 是服务端通信中心，方法默认对客户端公开（无需 [HubMethod] 特性）
- 用 Clients.All.SendAsync("ReceiveMessage", user, message) 广播消息
- 用 Clients.Caller.SendAsync(...) 回复调用者，Clients.Others.SendAsync(...) 推送他人
- 在 Program.cs 中注册服务并映射路由：
builder.Services.AddSignalR();和app.MapHub("/chat");
客户端：JS 端轻松连接与交互
引入 @microsoft/signalr npm 包或通过 CDN 加载，创建连接实例：
- 连接地址必须和服务端 Hub 路由一致，如
new HubConnectionBuilder().withUrl("/chat").build() - 用 connection.on("ReceiveMessage", (user, msg) => { ... }) 监听服务端推送的方法
- 用 connection.invoke("SendMessage", user, msg) 调用 Hub 中的公开方法（支持 async/await）
- 记得调用 connection.start() 启动连接，建议加
try/catch处理失败
连接与状态：别忽略生命周期管理
真实场景中网络可能中断，用户可能刷新页面——SignalR 提供了基础事件帮你应对：
- onreconnected：重连成功后触发，适合恢复 UI 状态或补发未确认消息
- onreconnecting：开始重试时触发，可显示“正在重连…”提示
- onclose：连接彻底断开（如用户关闭标签页），可用于清理资源或记录离线
- Hub 方法内可通过 Context.ConnectionId 获取当前连接标识，用于点对点通信或上下文关联
安全与实用细节：上线前必看
默认 Hub 方法对所有已连接客户端开放，生产环境需主动加固：
- 用 [Authorize] 特性限制访问，配合 JWT 或 Cookie 认证中间件
- 避免在 Hub 方法中执行耗时同步操作，优先使用 async/await + 非阻塞 I/O
- 广播大量数据时注意序列化开销，大消息建议分片或改用流式传输（SignalR 6+ 支持 StreamResult）
- 开发阶段开启日志：
builder.Logging.AddConsole().AddFilter("Microsoft.AspNetCore.SignalR", LogLevel.Debug);
基本上就这些。跑通一个“发消息→实时收到”的例子只需十几行代码，但真正用好 SignalR，关键在理解 Hub 生命周期、连接状态流转和前后端职责边界。
