.NET 10 Blazor WebAssembly无预渲染时生命周期方法不触发求助

问题描述 #

将Blazor WebAssembly项目从.NET 9升级到.NET 10后，使用以下无预渲染模式配置时，客户端的OnInitialized、OnInitializedAsync等生命周期方法不再触发，而.NET 9中这些方法是正常执行的：

@rendermode @(new InteractiveWebAssemblyRenderMode(prerender: false))

相关页面代码示例：

@page "/"

@using System.Security.Claims
@using shared_library.Layout
@using webapp_blazor.Client.Servicios;

@layout LayoutRaiz

@rendermode @(new InteractiveWebAssemblyRenderMode(prerender: false))
 
@inject Servicio_AuthenticationStateProvider_Wasm _Servicio_AuthenticationStateProvider
@inject NavigationManager _NavigationManager

@code {
    protected async override Task OnInitializedAsync()
    {
        var authenticationState = await _Servicio_AuthenticationStateProvider.GetAuthenticationStateAsync();
        ClaimsPrincipal _ClaimsPrincipal = authenticationState.User;

        /*另一种验证是否登录的方式*/
        if (!authenticationState.User.Identity.IsAuthenticated)
        {
            _NavigationManager.NavigateTo("/Autenticar_wasm");
        }
        else
        {
            _NavigationManager.NavigateTo("/Inicio_wasm");
        }
    }

    protected async override void OnAfterRender(bool firstRender)
    {
        var authenticationState = await _Servicio_AuthenticationStateProvider.GetAuthenticationStateAsync();
        ClaimsPrincipal _ClaimsPrincipal = authenticationState.User;

        /*另一种验证是否登录的方式*/
        if (!authenticationState.User.Identity.IsAuthenticated)
        {
            _NavigationManager.NavigateTo("/Autenticar_wasm");
        }
        else
        {
            _NavigationManager.NavigateTo("/Inicio_wasm");
        }
        
    }
}

解决办法 #

1. 调整组件渲染模式标记 #

改用特性标记的方式设置渲染模式，替代原有的@rendermode语法，可恢复.NET 9的生命周期执行逻辑：

@attribute [RenderModeInteractiveWebAssembly(prerender: false)]

2. 全局配置默认渲染模式 #

若希望所有组件统一使用该行为，可在Program.cs中配置WebAssembly主机时指定全局默认：

builder.RootComponents.Add<App>("#app", new InteractiveWebAssemblyRenderMode(prerender: false));

3. 适配生命周期方法 #

针对身份验证跳转的场景，可改用OnAfterRenderAsync方法（修改为异步返回Task），确保组件首次渲染后执行逻辑：

protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender)
    {
        var authenticationState = await _Servicio_AuthenticationStateProvider.GetAuthenticationStateAsync();
        if (!authenticationState.User.Identity.IsAuthenticated)
        {
            _NavigationManager.NavigateTo("/Autenticar_wasm");
        }
        else
        {
            _NavigationManager.NavigateTo("/Inicio_wasm");
        }
    }
}

4. 检查基础配置 #

• 确保index.html（独立模式）或_Host.cshtml（托管模式）中正确引用Blazor WebAssembly脚本：

<script src="_framework/blazor.webassembly.js"></script>

• 打开浏览器控制台，排查是否有JavaScript错误阻止Blazor运行时初始化。

行为变更原因 #

微软调整该行为是为了优化无预渲染模式下的首次加载体验，让页面先展示静态内容（若存在），再激活交互组件。但这会导致依赖生命周期方法的初始化逻辑延迟或不触发，需要通过上述配置或代码调整适配。

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