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<chathub>("/chat");</chathub>
客户端：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 生命周期、连接状态流转和前 后端 职责边界。
