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 生命周期、连接状态流转和前后端职责边界。
