Blazor Server依赖注入解析出错时，如何跳转至错误页面？

问题场景 #

Blazor Server应用中，点击内部链接进入某页面时，页面依赖的IAbcApiClient在依赖注入（DI）解析阶段抛出错误（例如无效URI配置），直接导致Blazor电路中断，UI陷入卡顿状态，无法自动恢复到友好状态。

已尝试的无效方案 #

• 在Program.cs服务注册代码builder.Services.AddApiClients(builder.Configuration);处添加try-catch：仅完成服务注册逻辑，未触发实际的DI解析，无法捕获运行时解析错误。
• 自定义CustomCircuitHandler：仅能记录错误日志，无法中断卡顿状态或引导用户至错误页面。
• MainLayout中配置ErrorBoundary：无法捕获组件初始化阶段的DI解析错误。
• app.UseExceptionHandler：仅在手动输入页面URL时生效，点击内部链接跳转时无法触发。

最优处理方案 #

方案1：组件级延迟加载+ErrorBoundary捕获解析错误 #

通过手动延迟解析依赖并配合ErrorBoundary，在组件层面捕获DI解析错误，避免电路中断。

1. 创建延迟加载页面组件（LazyAbcPage.razor）：

@page "/abc-page"
@inject IServiceProvider ServiceProvider

<ErrorBoundary>
    <ChildContent>
        @{
            try
            {
                // 手动解析依赖，捕获解析阶段异常
                var abcClient = ServiceProvider.GetRequiredService<IAbcApiClient>();
                // 渲染原页面组件，传入已解析的实例
                <AbcPage AbcClient="abcClient" />
            }
            catch (Exception ex)
            {
                <div class="alert alert-danger">
                    <h4>页面加载失败</h4>
                    <p>无法初始化API客户端：@ex.Message</p>
                </div>
            }
        }
    </ChildContent>
    <ErrorContent>
        <div class="alert alert-danger">
            <h4>页面加载异常</h4>
            <p>发生未知错误：@context.Message</p>
        </div>
    </ErrorContent>
</ErrorBoundary>

2. 修改原页面组件（AbcPage.razor），通过参数接收依赖实例：

@code {
    [Parameter, EditorRequired]
    public IAbcApiClient AbcClient { get; set; } = default!;

    // 原页面业务逻辑保持不变，不再直接注入IAbcApiClient
}

方案2：升级CircuitHandler拦截电路故障并主动跳转 #

改造现有CustomCircuitHandler，在电路关闭时通过JS互操作触发客户端跳转，强制脱离卡顿状态。

1. 升级CustomCircuitHandler：

public class CustomCircuitHandler : CircuitHandler
{
    private readonly ILogger<CustomCircuitHandler> _logger;
    private readonly IJSRuntime _jsRuntime;

    public CustomCircuitHandler(ILogger<CustomCircuitHandler> logger, IJSRuntime jsRuntime)
    {
        _logger = logger;
        _jsRuntime = jsRuntime;
    }

    public override async Task OnCircuitClosedAsync(Circuit circuit, CancellationToken cancellationToken)
    {
        _logger.LogError("Circuit {CircuitId} closed due to unhandled exception", circuit.Id);
        // 通过JS跳转至错误页面
        await _jsRuntime.InvokeVoidAsync("window.location.href", "/error");
    }

    public override Task OnConnectionDownAsync(Circuit circuit, CancellationToken cancellationToken)
    {
        _logger.LogError("Circuit {CircuitId} connection lost", circuit.Id);
        return Task.CompletedTask;
    }
}

2. 在Program.cs中注册该Handler：

builder.Services.AddSingleton<CircuitHandler, CustomCircuitHandler>();

方案3：提前验证配置，从根源避免解析错误 #

在服务注册阶段提前验证API客户端的配置有效性，将错误暴露在应用启动时，避免运行时电路中断。

修改AddApiClients扩展方法：

public static IServiceCollection AddApiClients(this IServiceCollection services, IConfiguration config)
{
    var abcApiConfig = config.GetSection("AbcApi").Get<AbcApiConfig>() 
        ?? throw new InvalidOperationException("未找到AbcApi配置");

    // 提前验证URI有效性
    if (!Uri.TryCreate(abcApiConfig.BaseUri, UriKind.Absolute, out var baseUri))
    {
        throw new InvalidOperationException($"无效的Abc API BaseUri：{abcApiConfig.BaseUri}");
    }

    services.AddHttpClient<IAbcApiClient, AbcApiClient>(client =>
    {
        client.BaseAddress = baseUri;
    });

    return services;
}

// 对应的配置模型
public class AbcApiConfig
{
    public string BaseUri { get; set; } = string.Empty;
}

方案优先级建议 #

1. 优先采用方案3：提前在启动阶段验证配置，从根源避免运行时DI解析错误。
2. 方案1作为运行时兜底：针对无法提前验证的依赖解析错误，通过组件级ErrorBoundary提供友好提示，避免电路中断。
3. 方案2作为全局兜底：捕获所有未处理的电路关闭事件，强制跳转至错误页面，避免用户停留在卡顿UI。

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