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

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

1. 什么是 SignalR？

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

核心特点包括：

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;
<p>public class ChatHub : Hub
{
public async Task SendMessage(string user, string message)
{
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}</p>

步骤 3：注册 SignalR 服务和路由

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

var builder = WebApplication.CreateBuilder(args);
<p>// 添加 SignalR 服务
builder.Services.AddSignalR();</p><p>var app = builder.Build();</p><p>app.UseRouting();</p><p>// 映射 Hub 路由
app.MapHub<ChatHub>("/chathub");</p><p>app.Run();</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1915" title="Summarizer"><img
                                                                                src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221135733179290.jpg" alt="Summarizer"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1915" title="Summarizer">Summarizer</a>
                                                                        <p>基于 AI 的文本段落摘要生成器</p>
                                                                </div>
                                                                <a href="/ai/1915" title="Summarizer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div>

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

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

安装客户端包

dotnet add package Microsoft.AspNetCore.SignalR.Client

连接并接收消息

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

4. 常见应用场景与技巧

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

分组通信

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

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

身份验证

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

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

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

错误处理与重连

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

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

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