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></bootstrapblazorroot>包裹 App，
<errorlogger></errorlogger>就已启用，异常自动记录并显示顶部提示 配置开关在
appsettings.json的
BootstrapBlazorOptions.EnableErrorLogger，设为
false即关闭（慎用） 想看详细错误？只需加一行：
"DetailedErrors": true（注意：它不在
BootstrapBlazorOptions内部，是同级配置） Ant Design Blazor 则依赖
IMessageService或
INotificationService主动推送，需手动调用
.Error()，不算纯“全局捕获”，但适合业务层精准反馈
手动实现跨环境通用的全局异常处理器
若用原生 Blazor 或需要更精细控制（比如记录到数据库、区分业务异常/系统异常），推荐封装一个
ErrorHandler组件： 新建
Shared/ErrorHandler.razor，用
<cascadingvalue></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 异常会丢失，变成“静默失败”
基本上就这些。框架本身已覆盖大部分崩溃防护，真正要花精力的是如何让错误信息对用户友好、对开发者可追溯——而不是反复造轮子捕获异常。
