Blazor ASP.NET 6：致.exe崩溃的未处理异常及全局处理问询

一、异常的两种影响场景 #

1. 仅重置Circuit，不崩溃应用 #

大部分Razor组件相关的未处理异常只会触发Circuit重置，不会搞挂整个.exe：

• 组件生命周期方法（OnInitializedAsync、OnParametersSetAsync等）抛异常
• 组件内UI绑定的事件方法（比如按钮点击逻辑）出错
• 组件内框架托管的异步任务未捕获异常
  这种情况Blazor框架会自动捕获异常，断开当前用户的Circuit（用户页面会重新加载），但整个应用进程不受影响。

2. 直接导致应用进程崩溃的场景 #

以下位置的未处理异常会直接搞挂.exe：

• AuthenticationStateProvider的事件处理逻辑：比如AuthenticationStateChanged的订阅方法，因为这类事件跑在框架核心的后台调度线程里，没捕获的异常会直接冒泡到进程层面
• 应用启动阶段的异常：比如Program.cs里配置服务、注册组件时的致命错误，或者Blazor初始化时的问题
• 非框架托管的后台线程/Task.Run中的未处理异常：这类线程不受Blazor管控，异常没处理就会崩进程
• 框架核心服务的自定义扩展逻辑：比如自定义Blazor中间件、SignalR相关的扩展代码里的未处理异常

二、全局异常处理实现 #

1. 处理Circuit级异常（避免重置或自定义处理） #

• 用ErrorBoundary包裹根组件：在App.razor里把整个应用套进ErrorBoundary，捕获组件树内的异常，显示自定义错误页面，还能提供重试按钮：

<ErrorBoundary>
    <ChildContent>
        <Router AppAssembly="@typeof(App).Assembly">
            <Found Context="routeData">
                <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            </Found>
            <NotFound>
                <LayoutView Layout="@typeof(MainLayout)">
                    <p>抱歉，当前地址无内容。</p>
                </LayoutView>
            </NotFound>
        </Router>
    </ChildContent>
    <ErrorContent Context="exception">
        <div class="alert alert-danger">
            <h3>出错了！</h3>
            <p>@exception.Message</p>
            <button @onclick="() => ErrorBoundary.Reset()">重试</button>
        </div>
    </ErrorContent>
</ErrorBoundary>

• 注册Circuit全局异常回调：在Program.cs里配置CircuitOptions，添加异常处理逻辑：

builder.Services.AddServerSideBlazor(options =>
{
    options.DetailedErrors = true;
    options.UnhandledExceptionHandler = exception =>
    {
        // 记录Circuit异常日志
        Console.WriteLine($"Circuit异常: {exception.Message}");
    };
});

2. 处理进程级异常（防止.exe崩溃） #

• 捕获AppDomain未处理异常：在Program.cs最开头加这段，兜底捕获所有进程级未处理异常：

AppDomain.CurrentDomain.UnhandledException += (sender, args) =>
{
    var exception = args.ExceptionObject as Exception;
    // 记录致命异常日志
    Console.WriteLine($"进程致命异常: {exception?.Message}");
    // 这里可以加优雅退出的逻辑
};

• 处理未观察到的Task异常：避免后台Task的未处理异常崩进程：

TaskScheduler.UnobservedTaskException += (sender, args) =>
{
    Console.WriteLine($"未处理的Task异常: {args.Exception.Message}");
    args.SetObserved(); // 标记异常已处理，阻止进程崩溃
};

• AuthenticationStateProvider事件手动加try-catch：针对这类容易崩进程的事件，直接在处理逻辑里包裹异常捕获：

public class CustomAuthStateProvider : AuthenticationStateProvider
{
    public CustomAuthStateProvider()
    {
        AuthenticationStateChanged += HandleAuthStateChanged;
    }

    private void HandleAuthStateChanged(Task<AuthenticationState> task)
    {
        try
        {
            // 你的状态变更处理逻辑
            var authState = task.Result;
        }
        catch (Exception ex)
        {
            // 捕获并处理异常，别让它往上冒
            Console.WriteLine($"认证状态变更出错: {ex.Message}");
        }
    }

    // 其他必要的实现代码...
}

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