Blazor全局异常处理核心是兜底捕获未处理异常、避免崩溃并提供友好提示与日志；默认模板含自动错误UI，组件库如BootstrapBlazor内置日志，原生场景可封装ErrorHandler组件统一处理。
Blazor 处理全局异常的方式取决于运行模式（Server / WebAssembly）和所用组件库，但核心思路一致：**兜底捕获未处理异常，避免页面崩溃，同时提供友好的提示与日志记录**。默认模板已内置基础机制，多数场景下无需从零写中间件。
Blazor 自带的全局错误 UI（无需额外配置）
所有 Blazor 项目模板（.NET 6+）都默认包含一个轻量级全局异常提示条：
- 开发环境：底部黄色横条，点击可跳转浏览器控制台查看堆栈
- 生产环境：同位置显示简短提示（如“发生错误，请刷新页面”），样式由
blazor-error-uiCSS 类控制 - 该 UI 由框架自动注入，只要没在
MainLayout.razor.css中设为display: none就会生效 - 不推荐直接禁用，但可自定义其内容——比如在
MainLayout.razor中根据IHostEnvironment.IsProduction()动态显示不同文案
BootstrapBlazor 等封装库的自动异常日志（开箱即用）
像 BootstrapBlazor、Ant Design Blazor、MudBlazor 这类主流组件库，通常已在根组件中集成异常拦截能力：
- BootstrapBlazor：只要用了
<BootstrapBlazorRoot>包裹 App，<ErrorLogger>就已启用，异常自动记录并显示顶部提示 - 配置开关在
appsettings.json的BootstrapBlazorOptions.EnableErrorLogger，设为false即关闭（慎用） - 想看详细错误？只需加一行：
"DetailedErrors": true（注意：它不在BootstrapBlazorOptions内部，是同级配置） - Ant Design Blazor 则依赖
IMessageService或INotificationService主动推送，需手动调用.Error()，不算纯“全局捕获”，但适合业务层精准反馈
手动实现跨环境通用的全局异常处理器
若用原生 Blazor 或需要更精细控制（比如记录到数据库、区分业务异常/系统异常），推荐封装一个 ErrorHandler 组件：
- 新建
Shared/ErrorHandler.razor，用<CascadingValue>向下透传 - 注入
ILogger记录异常，注入IJSRuntime可选弹窗或通知 - 暴露
HandleExceptionAsync(Exception)方法，供子组件调用（例如表单提交失败时） - 在
App.razor最外层包裹：<ErrorHandler><CascadingAuthenticationState>...</CascadingAuthenticationState></ErrorHandler> - 进阶做法：配合
CircuitHandler（Server 模式）监听连接断开，提前清理资源或提示用户
关键注意事项
别踩这些常见坑：
-
WebAssembly 没有服务端中间件：不能用 ASP.NET Core 的
UseExceptionHandler，必须靠组件级或 JS 互操作兜底 -
DialogService、JS 互操作异常要单独捕获：比如
DialogService.ShowAsync()抛异常不会触发blazor-error-ui，得自己try-catch -
不要在每个方法里重复 try-catch：优先用全局处理器 + 业务层抛
UserFriendlyException，再统一格式化返回 - 异步操作务必 await 并捕获：未 await 的 Task 异常会丢失，变成“静默失败”
基本上就这些。框架本身已覆盖大部分崩溃防护，真正要花精力的是如何让错误信息对用户友好、对开发者可追溯——而不是反复造轮子捕获异常。
