SignalR搭配Redis backplane多服务器环境下向指定用户发消息失效问题

核心问题根因 #

故障本质是Hub类未添加[Authorize]授权特性，导致多实例+Redis背板场景下，SignalR无法将WebSockets连接和对应用户身份做绑定：

• 本地单实例环境下，连接和消息推送都在同一台服务器，临时存储的连接信息可匹配身份，所以功能正常
• 多实例环境下，未经过认证流程的连接无法生成跨实例一致的用户订阅标识，即使Redis背板已经推送了定向用户消息，也找不到对应连接的订阅关系，因此客户端收不到msguser事件，而全员广播不需要匹配用户身份，所以可以正常触发。

分步修复方案 #

1. 补全Hub授权配置 #

给自定义Hub类添加[Authorize]特性，触发SignalR的身份解析流程：

[Authorize]
public class ImpersonationHub : Hub
{
    // 原有Hub业务逻辑保持不变
}

2. 修复WebSockets协议降级问题 #

添加[Authorize]后连接降级为长轮询，是因为Azure App Service默认关闭了WebSockets支持，手动开启即可：

• 登录Azure Portal，进入对应App Service的配置页面
• 依次打开「设置」-「配置」-「常规设置」
• 找到「Web 套接字」选项，切换为开启状态后保存并重启应用

3. 验证自定义UserIdProvider实现逻辑 #

你自定义了NameUserIdProvider作为用户标识解析类，要确保多实例下解析逻辑完全一致，参考实现：

public class NameUserIdProvider : IUserIdProvider
{
    public string GetUserId(HubConnectionContext connection)
    {
        // 此处取的Claim类型必须和你系统身份认证发放的Claim类型完全匹配
        return connection.User?.FindFirst(ClaimTypes.Name)?.Value;
    }
}

4. 客户端连接携带认证凭证 #

JavaScript客户端建立SignalR连接时，必须携带合法的身份认证凭证（比如JWT令牌），示例代码：

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/impersonationHub", {
        accessTokenFactory: () => localStorage.getItem("your_auth_token_key")
    })
    .build();

效果验证 #

完成以上配置后，多实例环境下：

• WebSockets协议可正常使用，不会降级为长轮询
• Clients.User(username)定向推送的msguser事件可正常触达对应用户
• 全员广播、定向推送功能均和本地单实例环境表现一致

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