Blazor WebAssembly中如何全局捕获Razor.cs文件异常并在控制台输出？

针对你要捕获所有Razor组件错误并输出到浏览器控制台的需求，以下是具体实现建议：

1. 全局未处理异常捕获（直接在Program.cs中配置） #

Blazor WebAssembly中可以通过注册全局异常事件，捕获绝大多数未处理的异常（包括组件异步任务、全局代码中的错误），直接在Program.cs中添加以下代码即可：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// 注册全局未处理异常捕获
AppDomain.CurrentDomain.UnhandledException += (sender, args) =>
{
    var exception = args.ExceptionObject as Exception;
    if (exception != null)
    {
        Console.WriteLine($"[全局未处理异常] 类型：{exception.GetType().Name}");
        Console.WriteLine($"消息：{exception.Message}");
        Console.WriteLine($"调用栈：{exception.StackTrace}");
    }
};

// 捕获未被观察到的异步任务异常
TaskScheduler.UnobservedTaskException += (sender, args) =>
{
    foreach (var exception in args.Exception.InnerExceptions)
    {
        Console.WriteLine($"[未观察到的任务异常] 类型：{exception.GetType().Name}");
        Console.WriteLine($"消息：{exception.Message}");
        Console.WriteLine($"调用栈：{exception.StackTrace}");
    }
    args.SetObserved(); // 标记异常已处理，避免程序终止
};

builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });

await builder.Build().RunAsync();

这种方式可以覆盖组件中未被try/catch捕获的异步操作错误、全局初始化代码错误等场景。

2. 组件级全局错误边界（覆盖所有Razor组件的渲染/交互错误） #

如果要精准捕获组件渲染、生命周期方法、用户交互事件中的错误，可以通过封装全局ErrorBoundary组件实现：

步骤1：创建全局错误边界组件 #

新建GlobalErrorBoundary.razor文件：

<ErrorBoundary @ref="_errorBoundary">
    @ChildContent
</ErrorBoundary>

@code {
    [Parameter] public RenderFragment ChildContent { get; set; }
    private ErrorBoundary _errorBoundary;

    protected override void OnInitialized()
    {
        // 订阅组件错误事件
        _errorBoundary.OnError += (sender, errorArgs) =>
        {
            var exception = errorArgs.Exception;
            Console.WriteLine($"[组件异常] 位置：{errorArgs.ComponentId ?? "未知组件"}");
            Console.WriteLine($"类型：{exception.GetType().Name}");
            Console.WriteLine($"消息：{exception.Message}");
            Console.WriteLine($"调用栈：{exception.StackTrace}");
            
            // 可选：自动恢复组件状态，不显示错误UI
            _errorBoundary.Recover();
        };
    }
}

步骤2：在App.razor中全局包裹 #

修改App.razor，用全局错误边界包裹整个路由结构：

<GlobalErrorBoundary>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p role="alert">Sorry, there's nothing at this address.</p>
            </LayoutView>
        </NotFound>
    </Router>
</GlobalErrorBoundary>

这种方式可以捕获所有子组件在渲染、事件触发时的错误，和Program.cs的全局事件配合，几乎能覆盖所有异常场景。

关键说明 #

• Blazor WebAssembly中没有ASP.NET Core服务器端那样的HTTP中间件概念，你要的全局错误捕获是通过全局异常事件和组件错误边界实现的，并非传统意义的中间件。
• Program.cs是配置全局异常事件的合适位置，而全局错误边界组件则负责覆盖所有Razor组件的错误场景。

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