.NET 9.0 的 Blazor Web App 项目，Bootstrap Blazor 全局异常＜ErrorLogger＞使用备忘

一、全局异常通过 <ErrorLogger> 组件实现，可以对全局的日志、异常进行统一输出，该组件【已经包含】在 <BootstrapBlazorRoot> 中，使用了 <BootstrapBlazorRoot> 组件包裹的 razor组件【不用】再额外添加 <ErrorLogger> 组件包裹。

二、全局异常默认已经开启、后台自动生效，【不用】在项目中做其他任务额外操作，项目发布后执行时，自动拦截异常，项目不会因为发生异常而崩溃、导致不可用，可能会在页面顶端显示全局异常的简要说明，如下图所示。

三、如果要显示全局异常的详细说明，可以在 appsettings.json 中进行配置。注意，此配置在 "BootstrapBlazorOptions" 外面。

............

  //BB全局异常：是否输出详细错误信息
  "DetailedErrors": true,

............

  "BootstrapBlazorOptions": {
    "ToastDelay": 5000,
    "MessageDelay": 5000,
    "SwalDelay": 5000,

    //BB全局异常：不配置时，默认值为 true = 启用；false 禁用
    "EnableErrorLogger": true,

............

  }

四、如果要关闭默认开启的全局异常，可以 "BootstrapBlazorOptions" 中进行配置。关闭后，发现全局异常时，页面崩溃，显示如下图所示提示。

五、如果要将全局异常信息记录到日志文件中、方便事后查阅，操作步骤如下。

1. 通过【NuGet 包管理器】引用 Longbow.Logging 组件包。

2. 在 Program.cs 中注册服务。注册后，全局异常发生后，自动写入日志文件中，日志文件默认位于项目执行文件所在目录中的 Logs 子目录中。日志目录、文件名可以在注册时进行修改，如下示例代码中所示。

............

/* 全局异常（自动记录，也可以手动记录，例如 Logger.LogInformation 等）日志记录：先要清除默认的日志提供程序 */
builder.Logging.ClearProviders();  
builder.Services.AddLogging(builder => builder.AddFileLogger());
//builder.Services.AddLogging(builder => builder.AddFileLogger(options => { options.FileName = "LogsAbc\\Abc.log"; }));

............

3. 也可以手动记录日志到日志文件中，示例代码如下所示。

    @inject ILogger<Counter> Logger
    private void IncrementCount()
    {
        currentCount++;
        Logger.LogInformation("Counter incremented to {Count}", currentCount);
    }