SignalR Hub中Context.User.Identity.Name为空及401授权问题排查

核心问题分析 #

你遇到的问题本质是认证信息未被SignalR正确处理，即使Cookie已传递到服务器，也存在中间件顺序错误、客户端凭证配置缺失、Claim声明未正确添加等多个可能因素。以下是针对性的修复步骤：

1. 修正中间件执行顺序 #

中间件顺序错误会导致认证逻辑无法先于SignalR请求执行，调整program.cs中的中间件顺序为：

app.UseHttpsRedirection();

app.UseBlazorFrameworkFiles();
app.UseStaticFiles();

app.UseRouting();

// 将ResponseCompression移到路由之后，认证之前
app.UseResponseCompression();

// IdentityServer、认证、授权必须按此顺序执行
app.UseIdentityServer();
app.UseAuthentication();
app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
    endpoints.MapControllers();
    endpoints.MapHub<PaymentHub>("/ws/payment");
});
app.MapFallbackToFile("index.html");

2. 客户端配置凭证传递 #

Blazor WASM默认不会自动发送Cookie到SignalR服务器，必须显式开启凭证传递，修改客户端连接代码：

hubConnection = new HubConnectionBuilder()
    .WithUrl(navigationManager.ToAbsoluteUri("/ws/payment"), options =>
    {
        options.WithCredentials = true; // 关键：允许发送认证Cookie
    })
    .WithAutomaticReconnect()
    .Build();

3. 指定SignalR的认证方案 #

由于你同时配置了Cookie认证和IdentityServer JWT，需明确SignalR使用Cookie认证方案：

方式一：在Hub上直接指定 #

修改PaymentHub.cs：

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.SignalR;
using Microsoft.AspNetCore.Authentication.Cookies;

namespace BagiBagiDev.Server.Hubs
{
    // 指定使用Cookie认证方案
    [Authorize(AuthenticationSchemes = CookieAuthenticationDefaults.AuthenticationScheme)]
    public class PaymentHub : Hub
    {
        public async Task PaymentChange(string userId)
        {
            await Clients.All.SendAsync("Test", userId);
        }

        public override Task OnConnectedAsync()
        {
            // 现在可以正确获取Context.User.Identity.Name了
            var userName = Context.User.Identity.Name;
            return base.OnConnectedAsync();
        }
    }
}

方式二：全局配置SignalR认证方案 #

在program.cs中添加：

builder.Services.AddSignalR(options =>
{
    options.AuthenticationSchemes = CookieAuthenticationDefaults.AuthenticationScheme;
});

4. 确保ClaimsPrincipalFactory添加Name声明 #

你的ApplicationClaimsPrincipalFactory需要明确添加Name类型的Claim，否则Context.User.Identity.Name会为空。检查该工厂的实现：

public class ApplicationClaimsPrincipalFactory : UserClaimsPrincipalFactory<ApplicationUser, IdentityRole>
{
    public ApplicationClaimsPrincipalFactory(UserManager<ApplicationUser> userManager, 
        RoleManager<IdentityRole> roleManager, 
        IOptions<IdentityOptions> optionsAccessor) 
        : base(userManager, roleManager, optionsAccessor)
    {
    }

    protected override async Task<ClaimsIdentity> GenerateClaimsAsync(ApplicationUser user)
    {
        var identity = await base.GenerateClaimsAsync(user);
        // 强制添加Name声明，值为用户名
        identity.AddClaim(new Claim(System.Security.Claims.ClaimTypes.Name, user.UserName));
        return identity;
    }
}

5. 检查ProfileService的Claim输出 #

如果使用了IdentityServer的IProfileService，需确保它返回Name类型的Claim，否则JWT中不会包含该信息：

public class ProfileService : IProfileService
{
    private readonly UserManager<ApplicationUser> _userManager;

    public ProfileService(UserManager<ApplicationUser> userManager)
    {
        _userManager = userManager;
    }

    public async Task GetProfileDataAsync(ProfileDataRequestContext context)
    {
        var user = await _userManager.GetUserAsync(context.Subject);
        if (user != null)
        {
            // 添加Name Claim到返回的凭证中
            context.IssuedClaims.Add(new Claim(ClaimTypes.Name, user.UserName));
        }
    }

    public async Task IsActiveAsync(IsActiveContext context)
    {
        var user = await _userManager.GetUserAsync(context.Subject);
        context.IsActive = user != null;
    }
}

6. 调整Cookie的SameSite属性（跨域场景） #

如果客户端与服务器存在跨域（如不同端口），需配置Cookie的SameSite属性以确保浏览器能正常发送：

builder.Services.AddAuthentication()
    .AddCookie(options =>
    {
        options.Cookie.Name = "BagiBagiAuth.Cookie";
        options.ExpireTimeSpan = TimeSpan.FromDays(1);
        options.Cookie.SameSite = SameSiteMode.Lax; // 非跨域用Lax，跨域HTTPS用None
        options.Cookie.SecurePolicy = CookieSecurePolicy.Always; // 生产环境强制HTTPS
    })
    .AddIdentityServerJwt();

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