Blazor 与 SignalR 实现实时通信教程

来源:这里教程网 时间:2026-02-21 17:33:29 作者:

Blazor 和 SignalR 结合,能让你在 .NET 生态里轻松做出真正的实时交互页面,比如聊天室、实时仪表盘、协同编辑——不用写一堆 JavaScript 就能双向推拉数据。

为什么选 Blazor + SignalR 而不是纯 JS 方案?

Blazor(尤其是 Server 或 WebAssembly + Auto 模式)允许你用 C# 写前端逻辑;SignalR 则负责底层连接管理、自动重连、协议协商(WebSocket / Server-Sent Events / Long Polling)。两者配合,业务逻辑全在 C# 侧,前后端类型一致、调试统一、共享模型类,省去 JSON 序列化/反序列化的隐式成本和类型错位风险。

快速接入 SignalR 的三步走

服务端:注册 Hub 并启用 SignalR
Program.cs
中加:
builder.Services.AddSignalR();

app.MapHub<chathub>("/hub/chat");</chathub>
写一个 Hub 类(例如
ChatHub.cs
):
继承
Hub
,公开方法供客户端调用(如
SendAsync
),用
Clients.All.SendAsync
Clients.Group.SendAsync
推送消息。
客户端:在 Blazor 组件中连接 Hub 使用
@inject HubConnection
(Server)或
HubConnectionBuilder
(WASM),在
OnInitializedAsync
建连,
DisposeAsync
断连。记得处理
OnClosed
和重连逻辑。

Blazor Server 与 WASM 的关键差异点

Server 模式下,Hub 连接天然共享同一个 Circuit,可直接注入

HubContext
从服务层触发推送(比如数据库变更后通知前端);WASM 则必须走完整 HTTP + WebSocket 连接,无法直连服务容器,需通过 API 中间层或使用
HubConnection
手动管理生命周期。另外,WASM 客户端要引用
Microsoft.AspNetCore.SignalR.Client
包,并注意跨域和证书问题(尤其开发时用 HTTPS)。

避坑提醒:几个高频问题

Hub 方法参数必须是可序列化的简单类型或你定义的 DTO 类(别传
DbContext
IQueryable
Blazor Server 默认开启 Circuit 自动断开,长时间无操作会中断 SignalR 连接——可在
App.razor
里用
CircuitOptions
调整超时
WASM 中不要在
OnInitialized
启动连接,要用
OnInitializedAsync
+
await
,否则可能报“JS interop not ready”
调试时打开浏览器 Network 面板,看
/hub/chat
是否建立 WebSocket,避免被代理或防火墙静默拦截

基本上就这些。跑通一次连接、发一条消息、再收回来,后面就能按业务扩展分组、用户追踪、离线缓存了。

相关推荐