C# 如何使用 SignalR 实现实时通信_C# SignalR 实时通信开发指南

SignalR是ASP.NET提供的实时通信库，通过Hub模型实现服务器主动推送。首先创建ChatHub类处理消息，注册SignalR服务并映射/chathub路由，客户端使用HubConnection连接，调用InvokeAsync发送消息，On接收消息，支持分组、认证和重连机制，适用于聊天、通知等场景。

SignalR 是 ASP.NET 提供的一个强大库，用于简化服务器与客户端之间的实时通信。使用 C# 和 SignalR，你可以轻松实现聊天应用、实时通知、数据仪表盘等需要即时更新的功能。下面是一个实用的开发指南，帮助你快速上手 C# 中的 SignalR 实现。

1. 什么是 SignalR？

SignalR 是一个开源库，允许服务器主动向连接的客户端推送信息。它自动选择最佳通信方式（如 WebSockets、Server-Sent Events 或长轮询），开发者无需关心底层协议切换。

核心特点包括：

• 自动连接管理
• 支持多种客户端（浏览器、移动端、桌面应用）
• 简单易用的 Hub 模型进行方法调用

2. 创建 SignalR 服务端（ASP.NET Core）

以 ASP.NET Core 项目为例，搭建一个基础的 SignalR 服务。

步骤 1：安装 NuGet 包

在项目中安装 SignalR 服务端包：

dotnet add package Microsoft.AspNetCore.SignalR

步骤 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：注册 SignalR 服务和路由

在 Program.cs 中配置服务和中间件：

var builder = WebApplication.CreateBuilder(args);
// 添加 SignalR 服务
builder.Services.AddSignalR();
var app = builder.Build();
app.UseRouting();
// 映射 Hub 路由
app.MapHub("/chathub");
app.Run();

3. 客户端连接 SignalR（C# 控制台或 WPF 示例）

你可以使用 .NET 客户端连接到 SignalR 服务，比如控制台程序或 WPF 应用。

安装客户端包

dotnet add package Microsoft.AspNetCore.SignalR.Client

连接并接收消息

using Microsoft.AspNetCore.SignalR.Client;
var connection = new HubConnectionBuilder()
.WithUrl("https://www./link/7b7114a49b5827132d6097582ec1722d")
.Build();
// 接收服务端推送的消息
connection.On("ReceiveMessage", (user, message) =>
{
Console.WriteLine($"{user}: {message}");
});
await connection.StartAsync();
// 发送消息
await connection.InvokeAsync("SendMessage", "Alice", "Hello World!");

4. 常见应用场景与技巧

SignalR 不仅限于聊天功能，还可用于多种实时场景。

分组通信

将用户加入特定组，实现定向广播：

public override async Task OnConnectedAsync()
{
    await Groups.AddToGroupAsync(Context.ConnectionId, "NewsGroup");
}
// 向组内所有成员发送消息
await Clients.Group("NewsGroup").SendAsync("NewArticle", title);

身份验证

通过 JWT 或 Cookie 验证用户身份，Hub 中可访问 Context.User 获取用户信息。

确保在客户端连接时传递 token：

.WithUrl("https://www./link/7b7114a49b5827132d6097582ec1722d", options =>
{
    options.AccessTokenProvider = () => Task.FromResult("your-jwt-token");
})

错误处理与重连

添加重连逻辑提升稳定性：

connection.Closed += async (error) =>
{
    await Task.Delay(5000);
    await connection.StartAsync();
};

基本上就这些。SignalR 极大地简化了实时通信的开发流程，配合 C# 的强类型优势，能快速构建稳定高效的实时应用。只要理解 Hub 模型和客户端交互方式，就能灵活应用于各种业务场景。不复杂但容易忽略细节，比如连接生命周期管理和异常处理，建议结合日志监控完善健壮性。