C# SignalR入门 - 实现Web应用的实时双向通信

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 提供了基础事件帮你应对：

慧中标AI标书

慧中标AI标书是一款AI智能辅助写标书工具。

295

查看详情

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

以上就是C# SignalR入门 - 实现Web应用的实时双向通信的详细内容，更多请关注php中文网其它相关文章！