.NET 8 Blazor Web App 404后SignalR无法重连问题求助

问题描述 #

在.NET 8构建的Blazor Web App（Server+WASM）中，访问应用内不存在的地址跳转至404页面后，SignalR无法自动重连，必须完全退出浏览器才能恢复连接。

复现步骤 #

• 使用Visual Studio创建Server+WASM类型的Blazor应用；
• 创建包含SignalR的控制台项目，并设置该项目依赖于Blazor Server项目；
• 在Home组件中添加SignalR连接逻辑；
• 启动应用，首页加载完成后，在浏览器地址栏输入应用内不存在的页面地址，触发异常。

补充说明：用控制台项目承载SignalR是为了让.NET MAUI应用与Blazor Web App共用同一Hub，可提供示例项目（暂未上传至Git）。

解决思路 #

1. 全局管理SignalR连接实例 #

不要仅在Home组件中创建SignalR连接，改为在客户端Program.cs中注册单例连接，确保连接实例不会随组件销毁被回收：

builder.Services.AddSingleton(sp =>
{
    var navManager = sp.GetRequiredService<NavigationManager>();
    var hubConnection = new HubConnectionBuilder()
        .WithUrl($"{navManager.BaseUri}yourHubEndpoint")
        .WithAutomaticReconnect()
        .Build();
    return hubConnection;
});

后续在需要的组件中注入该单例连接使用即可。

2. 在404页面处理连接重连 #

在NotFound组件中注入SignalR连接实例，主动检查并触发重连：

@inject HubConnection HubConnection

@code {
    protected override async Task OnInitializedAsync()
    {
        if (HubConnection.State == HubConnectionState.Disconnected)
        {
            try
            {
                await HubConnection.StartAsync();
            }
            catch (Exception ex)
            {
                // 按需处理重连失败逻辑，比如记录日志
            }
        }
    }
}

3. 校验跨项目SignalR配置 #

由于SignalR承载在控制台项目，需确认：

• 控制台项目已正确配置Hub端点，且允许Blazor应用的跨域请求（若存在跨域场景）；
• Blazor客户端连接Hub的URL使用NavigationManager.BaseUri拼接，避免路径错误；
• 控制台项目的依赖配置未导致Hub服务无法被Blazor Server正确识别或访问。

4. 启用日志排查根源 #

在客户端Program.cs添加日志过滤，通过浏览器控制台查看重连失败的具体错误：

builder.Logging.AddFilter("Microsoft.AspNetCore.SignalR", LogLevel.Debug);
builder.Logging.AddFilter("Microsoft.AspNetCore.Http.Connections", LogLevel.Debug);

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