Blazor .NET 8配置UseExceptionHandler后未显示错误页面的解决方法

你遇到的核心问题是：UseExceptionHandler仅处理HTTP请求管道级别的错误（比如访问不存在的路由），而Blazor Server交互式组件内的点击事件异常属于组件生命周期内的异常，默认由Blazor内置的ErrorBoundary捕获并显示默认错误UI，不会触发HTTP级别的错误页面跳转。

以下是具体解决方案：

步骤1：配置全局组件异常导航逻辑 #

在Program.cs中，修改交互式Server组件的配置，添加未处理异常的导航处理：

builder.Services.AddInteractiveServerComponents(options =>
{
    options.DetailedErrors = builder.Environment.IsDevelopment();
    // 处理未捕获的组件异常
    options.OnUnhandledException = exceptionContext =>
    {
        var navigationManager = exceptionContext.Services.GetRequiredService<NavigationManager>();
        // 强制跳转到错误页面（forceLoad确保触发完整页面刷新）
        navigationManager.NavigateTo("/Error", forceLoad: true);
        // 标记异常已处理，避免默认错误UI显示
        exceptionContext.Handled = true;
    };
});

步骤2：确保Error页面可用且稳定 #

如果你的/Error页面是Blazor组件，建议设置为静态渲染模式，避免在应用异常状态下无法加载交互式组件：

@page "/Error"
@rendermode Static

<PageTitle>错误</PageTitle>

<h1>应用发生错误</h1>
<p>抱歉，系统遇到了未处理的异常，请稍后重试。</p>

步骤3：（可选）自定义ErrorBoundary处理 #

如果你希望更灵活地控制异常捕获后的行为，可以在App.razor中自定义ErrorBoundary的错误处理逻辑，替代全局配置：

<ErrorBoundary OnError="@HandleComponentError">
    <ChildContent>
        <Router AppAssembly="@typeof(App).Assembly">
            <Found Context="routeData">
                <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
                <FocusOnNavigate RouteData="@routeData" Selector="h1" />
            </Found>
            <NotFound>
                <PageTitle>未找到页面</PageTitle>
                <LayoutView Layout="@typeof(MainLayout)">
                    <p role="alert">抱歉，该地址不存在。</p>
                </LayoutView>
            </NotFound>
        </Router>
    </ChildContent>
</ErrorBoundary>

@code {
    [Inject]
    private NavigationManager NavigationManager { get; set; }

    private void HandleComponentError(Exception exception)
    {
        // 记录异常日志（可选）
        // Logger.LogError(exception, "组件发生未处理异常");
        NavigationManager.NavigateTo("/Error", forceLoad: true);
    }
}

验证效果 #

重新运行项目，点击计数器按钮到5触发异常时，页面会自动跳转到你定义的/Error页面，而非默认的blazor-error-ui提示。

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