Blazor布局冲突：指定页面用自定义布局仍触发MainLayout初始化

你遇到的问题本质是**AuthorizeRouteView的DefaultLayout机制**：即便页面通过@layout指定了自定义布局，Blazor仍会先初始化DefaultLayout（即你的MainLayout）实例，导致其OnInitializedAsync代码执行。这是因为AuthorizeRouteView在路由处理流程中，会先尝试加载默认布局，再根据页面的布局配置替换，但初始化动作已经触发。

以下是几种可行的解决办法：

方案1：移除全局默认布局，让页面自行指定布局 #

修改App.razor，去掉AuthorizeRouteView的DefaultLayout参数，之后让需要使用MainLayout的页面通过@layout MainLayout显式指定，不需要的页面（如PageWithOtherLayout）保留自定义布局配置即可。

修改后的App.razor代码：

<CascadingAuthenticationState>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <AuthorizeRouteView RouteData="@routeData" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <!-- 其余原有内容保持不变 -->
    </Router>
</CascadingAuthenticationState>

这种方式最直接，只有显式标记@layout MainLayout的页面才会初始化MainLayout，你的PageWithOtherLayout将完全不会触发其初始化逻辑。

方案2：在MainLayout中判断路由，跳过无关页面逻辑 #

如果不想修改全局布局配置，可以在MainLayout的初始化方法里判断当前路由，若是不需要执行认证跳转的页面（如/pagewithotherlayout），直接跳过后续逻辑。

修改后的MainLayout.razor代码：

@inject NavigationManager NavigationManager

@code {
    protected async override Task OnInitializedAsync()
    {
        // 提取当前路由路径，排除BaseUri影响
        var currentPath = NavigationManager.Uri.Replace(NavigationManager.BaseUri, "/");
        // 判断是否为无需执行逻辑的页面
        if (currentPath.Equals("/pagewithotherlayout", StringComparison.OrdinalIgnoreCase))
        {
            return; // 直接跳过后续认证与跳转逻辑
        }

        base.OnInitialized();
        var user = (await AuthStat).User;
        isAuth = user.Identity.IsAuthenticated;
        if (!isAuth)
        {
           NavigationManager.NavigateTo("./login");
        }
    }
}

方案3：用路由约定配置多布局（适合复杂场景） #

如果有大量不同布局的页面组，可以通过路由约定为不同路由前缀指定对应布局，避免全局默认布局的干扰。

在Program.cs中添加路由约定配置：

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor(options =>
{
    options.RootComponents.Add<App>("#app");
    options.RootComponents.Add<HeadOutlet>("head::after");
    
    // 为指定路由前缀的页面绑定MainLayout
    options.Conventions.AddPageRoute("/admin/{*page}", "/admin/{*page}", layout: typeof(MainLayout));
    // 为目标页面绑定NoMenuLayout
    options.Conventions.AddPageRoute("/pagewithotherlayout", "/pagewithotherlayout", layout: typeof(NoMenuLayout));
});

同时保持App.razor中AuthorizeRouteView不设置DefaultLayout，这样不同路由会自动应用对应的布局，不会触发无关布局的初始化。

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