在Linux版Azure App Service上使用SignalR遇连接问题求助

一、ASP.NET Core 服务端配置检查 #

• 确认Program.cs中正确注册并映射SignalR Hub：

  // 注册SignalR服务
  builder.Services.AddSignalR();
  
  // 映射Hub端点，替换成你的Hub类和路径
  app.MapHub<ChatHub>("/chathub");
  

• 配置正确的CORS策略，MAUI作为跨端客户端需要允许跨域请求，且必须启用AllowCredentials：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowMAUIClient", policy =>
      {
          policy.WithOrigins("https://your-maui-app-domain.com", "http://localhost:5000") // 替换成实际客户端地址
                .AllowAnyHeader()
                .AllowAnyMethod()
                .AllowCredentials(); // SignalR必须启用此项
      });
  });
  
  // 注意CORS中间件要放在MapHub之前
  app.UseCors("AllowMAUIClient");
  

• 不要额外添加AddAzureSignalR()配置，除非你明确使用了Azure SignalR服务（你的场景是自建SignalR，不需要这个）

二、Azure App Service Linux 环境验证 #

• Linux版App Service确实没有专门的SignalR配置面板，WebSocket默认启用，但可以手动确认：
  1. 打开Kudu工具（https://<你的应用名称>.scm.azurewebsites.net），进入Environment标签，查看WEBSOCKET_ENABLED是否为On
  2. 如果状态异常，在App Service的「配置>应用程序设置」中添加键WEBSOCKET_ENABLED，值设为On
• Basic B1计划资源有限（0.75 CPU/1GB内存），如果连接数较多可能导致资源耗尽，可临时升级到B2计划测试是否为资源问题
• 检查部署完整性：通过Kudu的Debug console进入wwwroot/bin目录，确认存在Microsoft.AspNetCore.SignalR.dll等相关依赖

三、.NET MAUI 客户端排查 #

• 确保客户端SignalR包版本与服务端一致（均为.NET 8对应的Microsoft.AspNetCore.SignalR.Client 8.x.x）
• 强制使用WebSocket传输，避免自动协商可能出现的问题，同时添加错误处理：

  var hubConnection = new HubConnectionBuilder()
      .WithUrl("https://<你的应用域名>/chathub", options =>
      {
          options.Transports = HttpTransportType.WebSockets;
          // 开发环境可临时禁用证书验证，生产环境务必移除
          options.HttpMessageHandlerFactory = _ => new HttpClientHandler
          {
              ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
          };
      })
      .Build();
  
  // 添加连接断开自动重连逻辑
  hubConnection.Closed += async (error) =>
  {
      await Task.Delay(TimeSpan.FromSeconds(5));
      await hubConnection.StartAsync();
  };
  
  try
  {
      await hubConnection.StartAsync();
  }
  catch (Exception ex)
  {
      // 记录具体异常信息，比如输出到控制台或MAUI日志
      Console.WriteLine($"连接失败：{ex.Message}");
  }
  

• 检查平台网络权限：
  • Android：在Platforms/Android/AndroidManifest.xml中添加<uses-permission android:name="android.permission.INTERNET" />
  • iOS：在Platforms/iOS/Info.plist中确保添加了网络访问权限（NSAppTransportSecurity配置允许HTTPS请求）
• 先测试客户端连接本地运行的服务端，如果本地正常，说明问题出在Azure部署或网络层面

四、日志分析定位问题 #

• 服务端启用SignalR详细日志：在appsettings.json中添加

  "Logging": {
      "LogLevel": {
          "Microsoft.AspNetCore.SignalR": "Debug",
          "Microsoft.AspNetCore.Http.Connections": "Debug"
      }
  }
  

• 通过Azure App Service的「监控>日志流」查看实时日志，关注SignalR连接相关的错误信息
• MAUI客户端记录完整异常栈，比如捕获StartAsync抛出的异常，查看是证书问题、网络超时还是路径错误

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