Blazor预渲染阶段调用NavigateTo抛出异常是否正常？

现象是否正常？ #

这是正常现象。Blazor预渲染是服务器端生成静态HTML的过程，此时没有客户端的导航上下文，调用NavigationManager.NavigateTo抛出NavigationException是框架的预期行为——服务器无法在预渲染阶段执行客户端导航操作，必须等客户端完成初始化、接管应用后才能正常触发导航。

是否需要迁移逻辑？如何操作？ #

需要将导航触发逻辑移至非预渲染阶段，以下是两种实用实现方式：

方式一：通过IsPreRendering属性判断执行时机 #

.NET 6及以上版本的ComponentBase内置了IsPreRendering属性，可直接判断当前是否处于预渲染阶段，仅在客户端接管后执行导航逻辑：

[Inject]
public NavigationManager NavManager { get; set; } = default!;

protected override async Task OnParametersSetAsync()
{
    // 预渲染阶段跳过导航检查
    if (!IsPreRendering)
    {
        await RedirectIfDataIsReady();
    }

    await base.OnParametersSetAsync();
}

private async Task RedirectIfDataIsReady()
{
    // 第三方数据就绪状态检查逻辑
    bool isDataReady = await CheckThirdPartyDataStatus();
    
    if (isDataReady)
    {
        NavManager.NavigateTo("my/other/page");
    }
}

方式二：在OnAfterRenderAsync中执行导航 #

OnAfterRenderAsync会在客户端初始化完成后执行（预渲染阶段也会触发一次，可通过IsPreRendering跳过），适合依赖客户端环境的场景：

[Inject]
public NavigationManager NavManager { get; set; } = default!;

// 标记是否已执行过检查，避免重复触发
private bool _hasCheckedData = false;

protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender && !IsPreRendering && !_hasCheckedData)
    {
        _hasCheckedData = true;
        await RedirectIfDataIsReady();
    }

    await base.OnAfterRenderAsync(firstRender);
}

private async Task RedirectIfDataIsReady()
{
    bool isDataReady = await CheckThirdPartyDataStatus();
    
    if (isDataReady)
    {
        NavManager.NavigateTo("my/other/page");
    }
}

内容的提问来源于stack exchange，提问作者Ben Zuill-Smith