Blazor Server中CircuitHandler方法未触发的原因排查

你的问题根源在于**.NET 8+的Blazor Server新托管模型下，CircuitHandler的注册方式不正确**。直接用AddSingleton<CircuitHandler, MyCircuitHandler>()注册，Blazor的电路系统不会主动识别并关联到生命周期事件，只有当你手动注入到组件时才会实例化，但不会触发电路相关的回调方法。

正确的注册方式 #

把Program.cs中注册CircuitHandler的代码，从：

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

替换为：

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents(options =>
    {
        options.DetailedErrors = true;
    })
    // 在这里添加CircuitHandler
    .AddCircuitHandler<MyCircuitHandler>();

完整修改后的Program.cs #

using CircuitHandlerTest;
using CircuitHandlerTest.Components;
using Microsoft.AspNetCore.Components.Server.Circuits;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents(options =>
    {
        options.DetailedErrors = true;
    })
    .AddCircuitHandler<MyCircuitHandler>(); // 调整为这种方式注册

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error", createScopeForErrors: true);
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseStaticFiles();
app.UseAntiforgery();

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

app.Run();

验证效果 #

修改后重新运行项目：

1. 打开浏览器访问应用，控制台会输出Constructor called.和OnCircuitOpenedAsync called.、OnConnectionUpAsync called.
2. 关闭浏览器标签页，控制台会输出OnConnectionDownAsync called.和OnCircuitClosedAsync called.

原因说明 #

在.NET 8引入的新托管模型（基于AddRazorComponents和AddInteractiveServerComponents）中，CircuitHandler需要通过组件服务的AddCircuitHandler扩展方法注册，这样Blazor框架才能将其纳入电路生命周期的管理链条中。直接注册Singleton只是把服务放入DI容器，但框架不会主动将其关联到电路事件的触发机制里。

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