Blazor ErrorBoundary全局处理业务规则异常：页面刷新问题及优化问询

我需要实现全局层面的业务规则验证处理，要求抛出BusinessRuleException时向用户推送错误通知。目前基于Blazor的ErrorBoundary自定义了处理类，功能正常，但每次触发异常都会导致整个页面刷新，体验不佳，希望得到更优的实现建议。

当前实现代码 #

自定义Boundary类：

using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Rendering;
using Microsoft.AspNetCore.Components.Web;
using MyProjects.Core.Exceptions;
using Radzen;

namespace MyProjects.Infrastructure
{
    public class MyProjectsBusinessRuleErrors : ErrorBoundary
    {
        [Inject]
        private NotificationService _notificationService { get; set; } = default!;

        protected override void OnInitialized()
        {
            base.OnInitialized();
        }

        protected override Task OnErrorAsync(Exception exception)
        {
            if(exception is BusinessRuleException)
            {
                _notificationService.Notify(NotificationSeverity.Error, exception.Message);

                return Task.CompletedTask;
            }

            return base.OnErrorAsync(exception);
        }

        protected override void BuildRenderTree(RenderTreeBuilder builder)
        {
            if (CurrentException is null || CurrentException is BusinessRuleException)
            {
                builder.AddContent(0, ChildContent);
            }
            else
            {
                base.BuildRenderTree(builder);
            }
        }
    }
}

MainLayout.razor：

@inherits LayoutComponentBase
@using MyProjects.Infrastructure

<RadzenTooltip/>
<RadzenDialog/>
<RadzenNotification/>

<PageTitle>MyProjects</PageTitle>

<div class="page">
    <main>
        <article class="content px-4">
            <MyProjectsBusinessRuleErrors @ref="errorBoundary">
                <ChildContent>
                    @Body
                </ChildContent>
                <ErrorContent>
                    An error has occured
                </ErrorContent>
            </MyProjectsBusinessRuleErrors>
        </article>
    </main>
</div>

代码后置文件：

using MyProjects.Infrastructure;

namespace MyProjects.Shared
{
    public partial class MainLayout
    {
        MyProjectsBusinessRuleErrors? errorBoundary { get; set; }

        protected override void OnParametersSet()
        {
            errorBoundary?.Recover();

            base.OnParametersSet();
        }
    }
}

问题根源分析 #

页面刷新的核心原因是MainLayout的OnParametersSet方法中强制调用了errorBoundary?.Recover()——每次路由切换或组件参数更新时，这个方法都会触发，强制重置ErrorBoundary状态，即使是当前页面内触发的业务异常，也会引发组件树的不必要重新渲染，导致页面刷新感。此外，当前自定义ErrorBoundary在处理业务异常后没有主动重置状态，依赖外部恢复的逻辑不够严谨。

优化方案 #

1. 让ErrorBoundary自动处理并恢复业务异常

修改自定义MyProjectsBusinessRuleErrors类，在捕获BusinessRuleException后直接调用Recover()重置状态，避免组件停留在错误状态：

using Microsoft.AspNetCore.Components;
using MyProjects.Core.Exceptions;
using Radzen;

namespace MyProjects.Infrastructure
{
    public class MyProjectsBusinessRuleErrors : ErrorBoundary
    {
        [Inject]
        private NotificationService _notificationService { get; set; } = default!;

        protected override async Task OnErrorAsync(Exception exception)
        {
            if (exception is BusinessRuleException businessEx)
            {
                // 推送业务错误通知
                _notificationService.Notify(NotificationSeverity.Error, businessEx.Message);
                // 立即恢复异常状态，组件无需进入错误UI
                Recover();
                return;
            }

            // 非业务异常交给基类处理
            await base.OnErrorAsync(exception);
        }

        protected override void BuildRenderTree(RenderTreeBuilder builder)
        {
            // 业务异常已恢复，始终渲染子内容；其他异常使用基类错误UI
            if (CurrentException is null || CurrentException is BusinessRuleException)
            {
                builder.AddContent(0, ChildContent);
            }
            else
            {
                base.BuildRenderTree(builder);
            }
        }
    }
}

2. 移除MainLayout中不必要的Recover调用

删除MainLayout后置文件中OnParametersSet内的errorBoundary?.Recover()，业务异常已在ErrorBoundary内部处理，路由切换时Blazor会自动管理组件状态：

using MyProjects.Infrastructure;

namespace MyProjects.Shared
{
    public partial class MainLayout
    {
        MyProjectsBusinessRuleErrors? errorBoundary { get; set; }

        protected override void OnParametersSet()
        {
            base.OnParametersSet();
        }
    }
}

3. 局部ErrorBoundary精细化处理（可选）

如果部分组件需要独立处理异常，避免全局影响，可以在业务组件内嵌套局部ErrorBoundary，局部异常不会触发全局组件重新渲染：

<!-- 业务组件示例 -->
<MyProjectsBusinessRuleErrors>
    <ChildContent>
        <button @onclick="HandleSubmit">提交数据</button>
    </ChildContent>
</MyProjectsBusinessRuleErrors>

@code {
    private async Task HandleSubmit()
    {
        // 模拟触发业务规则异常
        throw new BusinessRuleException("提交失败：手机号格式不正确");
    }
}

额外注意事项 #

• 严格区分BusinessRuleException和系统级异常（如IO异常、数据库异常），确保业务异常仅用于验证失败、权限不足等业务逻辑场景。
• 如果需要保留异常触发前的组件输入状态，可以不调用Recover()，而是通过组件内部状态控制UI渲染，但需注意及时清理异常状态，避免内存泄漏。

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