.NET中的SignalR是什么?如何用它在Web应用中实现实时通信?

SignalR是.NET平台上的开源库,可实现Web应用的实时双向通信,支持WebSockets、SSE和长轮询,自动选择最佳传输方式。在ASP.NET Core中,通过AddSignalR注册服务,创建Hub类处理消息,前端用JavaScript客户端连接并收发数据,适用于聊天、通知、协作和监控等场景。

SignalR 是 .NET 平台上的一个开源库,用于简化 Web 应用中的实时双向通信功能。它允许服务器主动向客户端推送数据,而不需要客户端频繁轮询。这在聊天应用、实时通知、仪表盘更新等场景中非常有用。

SignalR 的核心特点

SignalR 能自动选择最佳的通信方式,根据浏览器和服务器的支持情况,在以下几种技术之间智能切换:

  • WebSockets: 全双工通信协议,性能最好,需要服务器和客户端都支持。
  • Server-Sent Events(SSE): 服务器单向推送到客户端。
  • 长轮询(Long Polling): 兼容性最好,适用于老旧环境。

开发者无需关心底层实现,SignalR 自动处理连接管理和降级机制。

如何在 ASP.NET Core 项目中使用 SignalR

下面是在一个 ASP.NET Core Web 应用中集成 SignalR 的基本步骤。

1. 添加 SignalR 服务

Program.cs 中添加 SignalR 服务:

var builder = WebApplication.CreateBuilder(args);

// 添加 SignalR 服务
builder.Services.AddSignalR();

var app = builder.Build();

// 配置中间件
app.UseRouting();
app.MapHub("/chat"); // 映射 Hub 路由

app.Run();
2. 创建 Hub 类

Hub 是 SignalR 的核心类,负责处理客户端与服务器之间的通信。

创建一个继承自 Hub 的类:

using Microsoft.AspNetCore.SignalR;

public class ChatHub : Hub
{
    public async Task SendMessage(string user, string message)
    {
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }
}

上面的方法将消息广播给所有连接的客户端。

3. 前端使用 JavaScript 连接 SignalR

在页面中引入 SignalR 客户端库(可通过 CDN 或 npm 安装):


然后建立连接并监听事件:

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/chat")
    .build();

// 启动连接
connection.start().catch(err => console.error(err));

// 接收服务器推送的消息
connection.on("ReceiveMessage", function (user, message) {
    const msg = document.createElement("div");
    msg.textContent = `${user}: ${message}`;
    document.getElementById("messages").appendChild(msg);
});

// 发送消息到服务器
function sendMessage() {
    const user = document.getElementById("user").value;
    const message = document.getElementById("message").value;
    connection.invoke("SendMessage", user, message).catch(err => console.error(err));
}
4. 在页面中添加 UI 元素





常见应用场景

SignalR 特别适合以下类型的功能:

  • 实时聊天室或客服系统
  • 通知中心(如新订单提醒)
  • 多人协作工具(如在线文档编辑)
  • 实时数据监控面板(股票、IoT 设备状态)

基本上就这些。只要配置好 Hub 和客户端连接,SignalR 就能帮你处理绝大部分实时通信的复杂性,让开发更高效。注意确保服务器支持 WebSocket,并在生产环境中配置反向代理(如 Nginx、IIS)时开启相关协议支持。