使用Redis作为背板的SignalR出现队列已满问题求助

我们在使用Redis作为背板的SignalR实现过程中，有时会遇到如下错误：

System.InvalidOperationException: The queue is full.

at Microsoft.AspNet.SignalR.Messaging.ScaleoutStream.Send(Func`2 send, Object state)

at Microsoft.AspNet.SignalR.Infrastructure.Connection.Send(ConnectionMessage message)

at Microsoft.AspNet.SignalR.ConnectionExtensions.Send(IConnection connection, String connectionId, Object value)

请问这是什么原因导致的？是用于横向扩展的MaxQueueLength限制了队列，还是其他因素？

主要诱因 #

• MaxQueueLength队列容量限制：这是最直接的原因。SignalR的ScaleoutStream内部维护了一个缓冲队列，默认容量为1000。当消息产生速度远快于Redis背板的同步速度时，队列会被快速填满，触发该异常。
• Redis性能瓶颈：如果Redis服务器CPU、内存负载过高，或者网络延迟较大，会导致SignalR无法及时将消息同步到Redis，进而造成队列阻塞堆积。
• 消息突发过载：短时间内大量消息涌入（比如批量推送通知、高并发用户操作触发消息），超出了队列缓冲能力和Redis的处理速率。
• 无效客户端连接堆积：大量客户端连接异常断开但未被正确清理时，SignalR会持续尝试向这些无效连接发送消息，导致消息堆积在队列中无法释放。

排查与验证方向 #

1. 调整或检查MaxQueueLength配置：可以通过代码修改队列容量，根据实际场景调整数值（避免过大导致内存压力）：

GlobalHost.Configuration.MaxQueueLength = 2000; // 按需调整

2. 监控Redis状态：用INFO stats等命令查看Redis的CPU占用、命令执行延迟、内存使用情况，确认是否存在性能瓶颈。
3. 对比消息生产与消费速率：统计单位时间内产生的消息量，以及Redis同步消息的处理速度，判断是否存在速率不匹配。
4. 排查客户端连接：检查是否存在大量无效或半开的客户端连接，及时清理无效连接避免消息堆积。

内容的提问来源于stack exchange，提问作者Robert