Blazor Server中SignalR新客户端连接未触发Hub.OnConnectedAsync问题

我按照微软官方教程在Blazor Server应用中实现SignalR功能，完整代码已上传至GitHub。执行以下代码创建HubConnection时：

_hubConnection = new HubConnectionBuilder()
    .WithUrl(url)
    .Build();

预期会触发Hub类的OnConnectedAsync方法，官方示例代码中此逻辑正常，但我的代码里该方法并未触发。我怀疑问题出在Program.cs的MapHub配置上——当前Blazor Server模板已移除Startup.cs，我对配置代码做了调整。

教程中的配置代码：

app.UseEndpoints(endpoints =>
{
    endpoints.MapBlazorHub();
    endpoints.MapFallbackToPage("/_Host");
    endpoints.MapHub<BlazorChatSampleHub>(BlazorChatSampleHub.HubUrl);
});

我的配置里，因为已经有app.MapBlazorHub();和app.MapFallbackToPage("/_Host");，所以只添加了：

app.MapHub<TapDeviceHub>(TapDeviceHub.HubUrl);

附上TapDevice.razor、TapDeviceHub.cs及Program.cs完整代码，求问题原因和解决办法。

排查方向与解决建议 #

• 验证HubUrl一致性
  确保客户端创建HubConnection时用的url和TapDeviceHub.HubUrl完全匹配，包括路径的大小写、是否带前置/。比如HubUrl定义为"/tapdevicehub"，客户端的url必须完全一致。

• 检查Hub类的实现
  确认TapDeviceHub正确继承自Hub，且OnConnectedAsync是重写方法（必须加override关键字）：

  public class TapDeviceHub : Hub
  {
      public override async Task OnConnectedAsync()
      {
          // 自定义逻辑
          await base.OnConnectedAsync();
      }
  }
  

• 调整Program.cs中的配置顺序
  Blazor Server中中间件/路由配置顺序很关键，MapHub要放在正确的位置，建议顺序如下：

  var app = builder.Build();
  
  app.UseStaticFiles();
  app.UseRouting();
  
  // 先配置SignalR Hub
  app.MapHub<TapDeviceHub>(TapDeviceHub.HubUrl);
  app.MapBlazorHub();
  app.MapFallbackToPage("/_Host");
  
  app.Run();
  

• 确认客户端启动了连接
  仅Build HubConnection不会触发OnConnectedAsync，必须在客户端代码中调用await _hubConnection.StartAsync();，且要处理可能的异常。

• 查看日志定位错误
  在Program.cs中添加日志输出，便于排查连接问题：

  builder.Logging.AddConsole();
  

  运行应用后查看控制台日志，检查是否有路由匹配失败、连接超时或权限相关的错误。

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