Blazor Server实现未登录自动跳转登录页及导航异常解决

问题根因 #

你遇到导航异常的核心原因有两个：

1. App.razor标签层级配置错误：<NotAuthorized>是AuthorizeRouteView的子级配置节点，不能和AuthorizeRouteView平级放在<Found>标签下，错误层级会导致组件渲染时出现递归导航、授权状态判定死循环，直接抛出导航异常。
2. 你参考的Blazor WebAssembly版本实现没有兼容Blazor Server的运行逻辑：一是没有处理Blazor Server启动时认证状态初始化的延迟，容易误判用户登录状态；二是跳转Identity登录页时没有触发整页重载，会被Blazor内部路由拦截抛出404。

正确实现步骤 #

1. 全局授权基础配置 #

你在_Imports.razor添加全局@attribute [Authorize]的操作是对的，不需要给每个Razor组件单独加授权特性，但要注意两类页面必须放开匿名权限：

• Identity框架自带的登录、注册、找回密码、第三方登录回调等Razor Pages页面（默认在/Identity/Account路径下），这类页面不属于Blazor组件路由体系，不需要单独加[AllowAnonymous]，在中间件层放行即可
• 自定义的公共页面、错误页、跳转辅助页

2. 修正App.razor组件层级 #

把<NotAuthorized>节点移动到AuthorizeRouteView标签内部作为子内容，修正后的完整代码如下：

@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Components.Authorization
@using LoginScaffolding.Pages

<CascadingAuthenticationState>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)">
                <!-- 未授权节点必须嵌套在AuthorizeRouteView内部 -->
                <NotAuthorized>
                    <LoginRedirect />
                </NotAuthorized>
            </AuthorizeRouteView>
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p role="alert">抱歉，当前访问的地址不存在。</p>
            </LayoutView>
        </NotFound>
    </Router>
</CascadingAuthenticationState>

3. 优化LoginRedirect.razor跳转逻辑 #

补充认证状态预校验、returnUrl拼接、整页强制跳转逻辑，避免误判和路由拦截，修正后的代码如下：

@attribute [AllowAnonymous]
@inject NavigationManager NavigationManager
@inject AuthenticationStateProvider AuthStateProvider

@code {
    protected override async Task OnInitializedAsync()
    {
        // 等待认证状态初始化完成，避免启动空窗期误判
        var authState = await AuthStateProvider.GetAuthenticationStateAsync();
        var isAuthenticated = authState.User.Identity?.IsAuthenticated ?? false;
        
        if (!isAuthenticated)
        {
            // 拼接当前访问路径作为returnUrl，登录后可直接返回原页面
            var currentRelativePath = NavigationManager.ToBaseRelativePath(NavigationManager.Uri);
            var loginUrl = $"/Identity/Account/Login?returnUrl={Uri.EscapeDataString("/" + currentRelativePath)}";
            // 加forceLoad: true触发整页跳转，因为Identity登录页是Razor Pages，不属于Blazor路由管辖
            NavigationManager.NavigateTo(loginUrl, forceLoad: true);
        }
    }
}

4. 检查Program.cs中间件配置 #

确认中间件顺序正确，放行静态资源和Identity相关路由，参考配置如下：

// 其他前置中间件配置
app.UseHttpsRedirection();
app.UseStaticFiles();

// 优先映射Razor Pages，放行Identity相关页面路由
app.MapRazorPages();

app.UseRouting();
// 认证中间件必须放在授权中间件之前
app.UseAuthentication();
app.UseAuthorization();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

常见问题排查 #

• 若出现无限跳转循环，检查登录页路径是否被全局授权规则拦截，确认/Identity/Account路径下的所有页面允许匿名访问
• 若跳转后抛出404错误，检查跳转代码是否加了forceLoad: true参数，没有该参数会被Blazor内部路由拦截，无法加载Razor Pages类型的登录页
• 若登录成功后无法返回原访问页，检查returnUrl参数是否做了URL编码，同时确认Identity登录页的returnUrl校验规则允许站内路径跳转

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