Blazor Server中事件处理器抛异常致应用崩溃而非显示错误UI的原因

为什么两种处理器都会导致应用崩溃？ #

• 同步void版本：事件触发线程不属于Blazor的UI同步上下文，抛出的异常是未捕获的线程异常，Blazor的错误捕获机制无法拦截，直接导致应用进程终止。
• 异步void版本：虽然通过InvokeAsync切换到了UI线程，但InvokeAsync只是将委托排入UI队列执行，这个委托抛出的异常不在Blazor组件生命周期的托管执行流程内，框架没有预设的捕获逻辑，因此同样会触发未捕获异常，导致应用崩溃。

如何触发Blazor默认错误UI？ #

要让异常被Blazor的错误处理机制识别，必须将异常纳入框架的错误边界（Error Boundary）体系中，最可靠的方式是利用内置的ErrorBoundary组件：

1. 在组件中注入或引用对应的ErrorBoundary实例
2. 在事件处理器中捕获异常，手动传递给错误边界的SetErrorAsync方法

示例代码：

[Inject] private ErrorBoundary? SearchErrorBoundary { get; set; }

private async void HandleSearchDebounceError(object sender, Exception ex)
{
    var wrappedError = new InvalidOperationException("搜索操作失败，请重试", ex);
    await SearchErrorBoundary?.SetErrorAsync(wrappedError)!;
}

同时在组件模板中用ErrorBoundary包裹搜索相关区域：

<ErrorBoundary @ref="SearchErrorBoundary">
    <InputText @bind-Value="SearchTerm" />
    <button @onclick="TriggerSearch">搜索</button>
</ErrorBoundary>

这样异常只会触发该区域的默认错误UI，不会导致整个应用崩溃。

错误处理策略建议 #

• 非核心功能（如搜索防抖）：优先显示局部错误提示（比如在搜索框下方展示"搜索失败，请重试"），同时记录错误日志。这种方式对用户体验干扰更小，无需触发错误UI。
• 核心功能异常：使用错误边界触发默认错误UI，同时在错误UI中添加重试按钮，让用户可以快速恢复功能。

生产环境的影响 #

• Blazor WebAssembly：未捕获异常会导致当前客户端的应用实例崩溃，用户需刷新页面恢复，不会影响服务器。
• Blazor Server：未捕获异常会断开当前用户的SignalR连接，用户会看到重新连接提示；若连接失败则需刷新页面，但不会导致服务器应用停止，其他用户不受影响。

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