Blazor Server集成SignalR遇Windows身份验证401未授权错误

问题背景 #

我正在为Blazor Server应用实现角色变更后的实时刷新功能——当前管理员修改用户角色后，用户必须手动刷新页面才能看到权限变化，计划通过集成SignalR解决这个问题。

我的应用授权逻辑：通过UserRoleManager.cs获取当前AuthenticationState，将用户角色ID添加到ClaimTypes.GroupSid声明中，并在App.razor中调用该类的UpdateUserRole方法，让AuthenticationStateProvider全局生效。

现有核心代码 #

App.razor

@code {
    protected override async Task OnInitializedAsync()
    {
        await UserRoleManager.UpdateUserRole();
    }
}

UserRoleManager.cs（初始版本）

public async Task UpdateUserRole()
{
    var authState = await _authenticationStateProvider.GetAuthenticationStateAsync();
    var user = authState.User;

    var userRolesList = _userRoleService.GetUserRolesListe();

    var currentUser = userRolesList.Where(ur => ur.WindowsUser == user.Identity?.Name)
                            .ToList();
    if (currentUser != null)
    {
        foreach (var roleId in currentUser)
        {
            var claimsIdentity = (ClaimsIdentity)user.Identity!;
            claimsIdentity.AddClaim(new Claim(ClaimTypes.GroupSid, roleId.RoleId.ToString()));
        }
    }
}

SignalR集成代码 #

UserRoleHub.cs

using Microsoft.AspNetCore.SignalR;

namespace MultipleProjectsSyncfusion.Hubs
{
    public class UserRoleHub : Hub
    {
        public async Task UpdateUserRoles(string userId)
        {
            await Clients.All.SendAsync("UpdateRoles", userId);
        }
    }
}

修改后的UserRoleManager.cs片段

public async Task UpdateUserRole()
{
 //.. 无关代码 
    var username = currentUser.FirstOrDefault(ur => ur.WindowsUser == user.Identity?.Name);

    var hubContext = _hubContext.Clients.All;
    await hubContext.SendAsync("UpdateUserRoles", username?.WindowsUser);
}

Admin.razor

protected override async Task OnInitializedAsync()
{
    // 无关代码 

    hubConnection = new HubConnectionBuilder()
 .WithUrl(NavigationManager.ToAbsoluteUri("/userhub"))
 .Build();

    hubConnection.On<string>("ReceiveRoleChangeNotification", async (user) =>
    {
        SelectedUser = user;
        StateHasChanged(); // 更新UI
    });

    await hubConnection.StartAsync();
}

错误信息 #

HttpRequestException: 响应状态码未指示成功: 401 (未授权)。

解决方法 #

1. 修复SignalR连接的身份认证问题 #

出现401是因为SignalR连接未携带用户身份凭据，Blazor Server中需确保连接时传递认证信息：
修改Admin.razor中的连接构建逻辑：

hubConnection = new HubConnectionBuilder()
    .WithUrl(NavigationManager.ToAbsoluteUri("/userhub"), options =>
    {
        // 针对Windows认证场景启用默认凭据
        options.UseDefaultCredentials = true;
        // 若使用Cookie认证，Blazor会自动携带，但需确保站点已启用Cookie认证
    })
    .Build();

同时在Program.cs中确保中间件顺序正确（认证授权需在SignalR之前）：

app.UseAuthentication();
app.UseAuthorization();

// 注册SignalR Hub
app.MapHub<UserRoleHub>("/userhub");

2. 统一Hub事件与客户端监听的名称 #

你的Hub中发送的事件是UpdateRoles，但客户端监听的是ReceiveRoleChangeNotification，名称不匹配会导致消息无法接收，需统一：
修改UserRoleHub.cs：

public async Task UpdateUserRoles(string userId)
{
    await Clients.All.SendAsync("ReceiveRoleChangeNotification", userId);
}

3. 修正HubContext的调用方式 #

UserRoleManager中无需调用Hub的方法，直接通过IHubContext发送事件即可：

// UserRoleManager.cs 中
await _hubContext.Clients.All.SendAsync("ReceiveRoleChangeNotification", username?.WindowsUser);

4. 确保角色更新能触发组件重新授权 #

收到角色变更通知后，需重新更新用户的声明并触发组件渲染，让授权组件感知到变化：

hubConnection.On<string>("ReceiveRoleChangeNotification", async (user) =>
{
    // 仅更新当前登录用户的角色
    if (user == (await _authenticationStateProvider.GetAuthenticationStateAsync()).User.Identity?.Name)
    {
        await UserRoleManager.UpdateUserRole();
        StateHasChanged();
    }
});

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