SignalR Redis Backplane 是微软官方提供的跨服务器消息广播方案,用于解决多实例部署时内存连接上下文不共享导致的群聊断连、通知丢失等问题;它通过 Redis PUB/SUB 实现各 SignalR 实例间的消息中继。

SignalR Redis Backplane 是什么,为什么必须用它做横向扩展
单台 SignalR 服务器只能处理本机连接的客户端通信;一旦部署多台服务器(比如负载均衡后),客户端 A 连在 Server1、客户端 B 连在 Server2,它们之间就无法通过 Hub.Clients.All 或 Hub.Clients.Group("g1") 实时互通 —— 因为内存中的连接上下文不共享。Redis Backplane 就是解决这个问题的官方方案:它让所有 SignalR 实例把广播消息发到 Redis,再由其他实例监听并本地投递。
不用它,Scale-Out 后会出现「消息只发给同台服务器上的客户端」,即群聊断连、通知丢失、在线状态不准等现象。
如何正确配置 Redis Backplane(.NET 6+)
注意:.NET 5 起已移除内置 Microsoft.AspNetCore.SignalR.Redis 包,改用 Microsoft.AspNetCore.SignalR.StackExchangeRedis,且必须搭配 StackExchange.Redis v2.6.72+(旧版有连接泄漏风险)。
- 安装 NuGet 包:
Microsoft.AspNetCore.SignalR.StackExchangeRedis - 在
Program.cs中注册(非 Startup.cs):
builder.Services.AddSignalR()
.AddStackExchangeRedis(options =>
{
options.Configuration = "your-redis-connection-string";
options.ChannelPrefix = "MyApp:SignalR"; // 避免多个环境/应用混用同一 Redis DB 时冲突
});
⚠️ 常见错误:
- 漏写
ChannelPrefix,导致测试环境和生产环境 Redis 消息互相干扰 - 用 localhost:6379 硬编码,容器或云环境 DNS 解析失败
- 未设置 Redis 连接超时或重试策略,高延迟时 Hub 方法卡住
Redis Backplane 的性能瓶颈和调优点
Redis 不是万能中继:每条 SignalR 广播(如 hubContext.Clients.All.SendAsync("msg", data))都会序列化成一条 Redis PUBLISH 消息,所有订阅该 channel 的 SignalR 实例再反序列化 + 本地分发。这意味着:
- 消息体越大,Redis 网络带宽和实例 CPU 压力越高
- 高频小消息(如每秒百次位置更新)会迅速打满 Redis 的 PUB/SUB 频道吞吐(实测单节点 Redis PUB/SUB 极限约 5–10 万 msg/s)
- 若某台 SignalR 实例临时失联(GC 暂停、网络抖动),它会错过期间所有 Redis 消息,且无法回溯 —— Backplane 本身不提供消息持久化或 ACK
建议:
- 对非关键消息(如心跳、状态提示)改用客户端轮询或 WebSocket ping/pong
- 敏感业务消息(如订单状态变更)不要走 Broadcast,改用
Clients.Client(connectionId)点对点推送,并由业务层保证投递(例如结合数据库 + 后台任务) - 压测时监控 Redis 的
pubsubnumpat和pubsubnumsub,确认各 SignalR 实例是否稳定订阅
替代方案对比:何时不该用 Redis Backplane
Redis Backplane 适合中小规模实时场景(千级并发、低频广播)。但遇到以下情况,应考虑其他路径:
- 需要消息有序、至少一次投递、失败重试 —— Redis PUB/SUB 不支持,得换 Kafka 或 Azure Service Bus
- 已有 Azure 环境且不想运维 Redis —— 可用
Microsoft.Azure.SignalR托管服务(本质是微软自建的分布式 backplane,兼容 API) - 仅需极简广播(如配置热更新通知),且可接受秒级延迟 —— 直接用 SQL Server Change Tracking + 轮询也比引入 Redis 更轻量
最常被忽略的一点:Backplane 解决的是「跨服务器消息分发」,不是「连接保持」或「粘性会话」问题。负载均衡器仍需开启 sticky session(或关闭,靠 SignalR 自动协商),否则 WebSocket 升级可能失败 —— 这和 Redis 无关,但常被一起排查。










