Azure SignalR中如何仅通过UserId向指定用户发送消息

你直接调用Clients.User()不生效的核心原因是SignalR默认需要从连接的用户Claims声明中读取UserId标识，且你不需要自行维护多Pod下的ConnectionId映射，Azure SignalR服务已经内置了多实例连接同步能力。

1. 配置身份验证，确保UserId写入Claims #

SignalR默认读取ClaimTypes.NameIdentifier类型的Claim作为用户ID，你需要在服务端配置身份验证时确保该声明存在，同时允许SignalR从查询参数读取JWT令牌（适配WebSocket连接场景）：

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            // 指定UserId对应的Claim类型，确保和你生成JWT时写入的类型一致
            NameClaimType = ClaimTypes.NameIdentifier,
            // 其余JWT验证配置按你原有逻辑补充
        };
        // 适配SignalR连接从查询参数取token
        options.Events = new JwtBearerEvents
        {
            OnMessageReceived = context =>
            {
                var accessToken = context.Request.Query["access_token"];
                var path = context.HttpContext.Request.Path;
                if (!string.IsNullOrEmpty(accessToken) &&
                    path.StartsWithSegments("/notificationUserHub"))
                {
                    context.Token = accessToken;
                }
                return Task.CompletedTask;
            }
        };
    });

// 注册Azure SignalR和Hub
builder.Services.AddSignalR().AddAzureSignalR();

2. 客户端连接时携带身份令牌 #

客户端建立SignalR连接时传入当前登录用户的有效JWT：

// 以JS客户端为例
const connection = new signalR.HubConnectionBuilder()
    .withUrl("/notificationUserHub", {
        // 返回当前登录用户的JWT令牌
        accessTokenFactory: () => localStorage.getItem("user_token")
    })
    .build();

3. （可选）自定义UserId读取规则 #

如果你不想用默认的ClaimTypes.NameIdentifier作为UserId，可以自定义IUserIdProvider实现：

public class CustomUserIdProvider : IUserIdProvider
{
    public string GetUserId(HubConnectionContext connection)
    {
        // 示例：从自定义的Claim类型中读取UserId
        return connection.User.FindFirstValue("custom_user_id");
    }
}

在Program.cs中注册自定义实现：

builder.Services.AddSingleton<IUserIdProvider, CustomUserIdProvider>();

4. 验证UserId一致性 #

确保你调用Clients.User(xxx)时传入的xxx值，和Claims中读取到的UserId完全一致（无大小写、前后空格等差异）。

配置完成后你写的推送代码就可以正常运行，完全不需要自行维护静态的ConnectionId映射，Azure SignalR会自动处理多Pod下的连接同步问题。

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