Blazor Web App 9(Server交互)JWT认证：未自动跳转登录页问题

针对你遇到的启动直接访问带[Authorize]特性的Index页面出现401错误、无法自动跳转登录页的问题，核心原因是Blazor Server预渲染机制：初始页面在服务器端渲染时，AuthorizeRouteView检测到未认证，渲染NotAuthorized块中的RedirectToLogin，但服务器端无法执行客户端导航，直接返回401；而先访问未保护页面后，客户端已加载Blazor应用，后续导航由客户端路由处理，能正常触发跳转。

以下是具体解决方案：

1. 修改RedirectToLogin组件，适配预渲染场景 #

调整组件逻辑，同时处理服务器端重定向和客户端导航：

@inject NavigationManager NavigationManager
@inject IAuthenticationStateProvider AuthStateProvider
@inject IHttpContextAccessor HttpContextAccessor

@code {
    protected override async Task OnInitializedAsync()
    {
        // 服务器端预渲染时，直接返回HTTP重定向
        if (HttpContextAccessor.HttpContext != null)
        {
            var returnUrl = NavigationManager.ToBaseRelativePath(NavigationManager.Uri);
            HttpContextAccessor.HttpContext.Response.Redirect($"login?returnUrl={Uri.EscapeDataString(returnUrl)}");
            return;
        }

        // 客户端渲染时，执行Blazor客户端导航
        var authState = await AuthStateProvider.GetAuthenticationStateAsync();
        if (!authState.User.Identity.IsAuthenticated)
        {
            var returnUrl = NavigationManager.ToBaseRelativePath(NavigationManager.Uri);
            NavigationManager.NavigateTo($"login?returnUrl={Uri.EscapeDataString(returnUrl)}", forceLoad: false);
        }
    }
}

2. 注册IHttpContextAccessor服务 #

在Program.cs中添加：

builder.Services.AddHttpContextAccessor();

3. 完善JWT认证的WebSocket处理 #

Blazor Server使用WebSocket维持连接，需在JWT配置中添加事件处理，确保WebSocket请求能正确携带令牌：

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        // 保留你原有的TokenValidationParameters配置
        options.Events = new JwtBearerEvents
        {
            OnMessageReceived = context =>
            {
                var accessToken = context.Request.Query["access_token"];
                var path = context.HttpContext.Request.Path;
                // 处理Blazor SignalR连接的令牌验证
                if (!string.IsNullOrEmpty(accessToken) && path.StartsWithSegments("/_blazor"))
                {
                    context.Token = accessToken;
                }
                return Task.CompletedTask;
            }
        };
    });

4. 确认认证服务配置正确性 #

确保Program.cs中已正确添加以下服务：

builder.Services.AddAuthorization();
builder.Services.AddCascadingAuthenticationState();
// 如果使用自定义认证状态提供者，注册它
// builder.Services.AddScoped<AuthenticationStateProvider, CustomAuthStateProvider>();

这样调整后，启动直接访问受保护页面时，服务器端会直接重定向到登录页；客户端导航场景下也能正常触发跳转，解决401错误问题。

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