17370845950

Blazor全局异常处理核心是兜底捕获未处理异常、避免崩溃并提供友好提示与日志；默认模板含自动错误UI，组件库如BootstrapBlazor内置日志，原生场景可封装ErrorHandler组件统一处理。

Blazor 处理全局异常的方式取决于运行模式（Server / WebAssembly）和所用组件库，但核心思路一致：**兜底捕获未处理异常，避免页面崩溃，同时提供友好的提示与日志记录**。默认模板已内置基础机制，多数场景下无需从零写中间件。

Blazor 自带的全局错误 UI（无需额外配置）

所有 Blazor 项目模板（.NET 6+）都默认包含一个轻量级全局异常提示条：

• 开发环境：底部黄色横条，点击可跳转浏览器控制台查看堆栈
• 生产环境：同位置显示简短提示（如“发生错误，请刷新页面”），样式由 blazor-error-ui CSS 类控制
• 该 UI 由框架自动注入，只要没在 MainLayout.razor.css 中设为 display: none 就会生效
• 不推荐直接禁用，但可自定义其内容——比如在 MainLayout.razor 中根据 IHostEnvironment.IsProduction() 动态显示不同文案

BootstrapBlazor 等封装库的自动异常日志（开箱即用）

像 BootstrapBlazor、Ant Design Blazor、MudBlazor 这类主流组件库，通常已在根组件中集成异常拦截能力：

• BootstrapBlazor：只要用了 包裹 App， 就已启用，异常自动记录并显示顶部提示
• 配置开关在 appsettings.json 的 BootstrapBlazorOptions.EnableErrorLogger，设为 false 即关闭（慎用）
• 想看详细错误？只需加一行："DetailedErrors": true（注意：它不在 BootstrapBlazorOptions 内部，是同级配置）
• Ant Design Blazor 则依赖 IMessageService 或

  

  INotificationService 主动推送，需手动调用 .Error()，不算纯“全局捕获”，但适合业务层精准反馈

手动实现跨环境通用的全局异常处理器

若用原生 Blazor 或需要更精细控制（比如记录到数据库、区分业务异常/系统异常），推荐封装一个 ErrorHandler 组件：

• 新建 Shared/ErrorHandler.razor，用 向下透传
• 注入 ILogger 记录异常，注入 IJSRuntime 可选弹窗或通知
• 暴露 HandleExceptionAsync(Exception) 方法，供子组件调用（例如表单提交失败时）
• 在 App.razor 最外层包裹：...
• 进阶做法：配合 CircuitHandler（Server 模式）监听连接断开，提前清理资源或提示用户

关键注意事项

别踩这些常见坑：

• WebAssembly 没有服务端中间件：不能用 ASP.NET Core 的 UseExceptionHandler，必须靠组件级或 JS 互操作兜底
• DialogService、JS 互操作异常要单独捕获：比如 DialogService.ShowAsync() 抛异常不会触发 blazor-error-ui，得自己 try-catch
• 不要在每个方法里重复 try-catch：优先用全局处理器 + 业务层抛 UserFriendlyException，再统一格式化返回
• 异步操作务必 await 并捕获：未 await 的 Task 异常会丢失，变成“静默失败”

基本上就这些。框架本身已覆盖大部分崩溃防护，真正要花精力的是如何让错误信息对用户友好、对开发者可追溯——而不是反复造轮子捕获异常。