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<ChatHub>("/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 安装）：
<script src="https://cdnjs.cloudflare.com/ajax/libs/microsoft-signalr/6.0.1/signalr.min.js"></script>
然后建立连接并监听事件：
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 元素
<input id="user" placeholder="用户名" /> <input id="message" placeholder="消息" /> <button onclick="sendMessage()">发送</button> <div id="messages"></div>
常见应用场景
SignalR 特别适合以下类型的功能：
实时聊天室或客服系统 通知中心（如新订单提醒） 多人协作工具（如在线文档编辑） 实时数据监控面板（股票、IoT 设备状态）基本上就这些。只要配置好 Hub 和客户端连接，SignalR 就能帮你处理绝大部分实时通信的复杂性，让开发更高效。注意确保服务器支持 WebSocket，并在生产环境中配置反向代理（如 Nginx、IIS）时开启相关协议支持。
