.NET MAUI连接Azure部署的SignalR失败，求助排查解决

Azure App Service免费层（F1）可能是潜在影响因素，但先从更常见的配置问题逐步排查：

1. 验证Azure端WebSocket配置有效性 #

虽然你已开启WebSocket和ARR Affinity，但需二次确认：

• 进入Azure App Service控制台 → 设置 > 配置 > 常规设置
• 确保「Web Socket」处于「开启」状态，「ARR Affinity」设为「On」
• 注意：免费层单实例最多支持60个并发连接，若测试场景超过此限制会导致连接失败，但单人测试一般不会触发。

2. 修正CORS配置冲突 #

你当前使用AllowAnyOrigin() + AllowCredentials()的组合违反浏览器CORS规则（移动端MAUI虽不受浏览器同源策略严格限制，但后端配置仍需合规）：

• 替换AllowAnyOrigin()为具体允许的源，例如MAUI移动端的自定义scheme或测试环境地址：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("SignalRCors", policy =>
      {
          policy.WithOrigins("app://your-maui-app-id", "https://your-test-domain.com")
                .AllowAnyHeader()
                .AllowAnyMethod()
                .AllowCredentials();
      });
  });
  

• 确保SignalR Hub启用此CORS策略：

  app.MapHub<OrderHub>("/orderHub").RequireCors("SignalRCors");
  

3. 添加前端连接异常捕获 #

你的代码未处理StartAsync()的异常，这是定位问题的关键：

Task.Run(async () =>
{
    try
    {
        await InvokeAsync(async () =>
        {
            await hubConnection.StartAsync();
        });
    }
    catch (Exception ex)
    {
        Console.WriteLine($"SignalR连接失败：{ex.Message}");
        if (ex.InnerException != null)
        {
            Console.WriteLine($"详细错误：{ex.InnerException.Message}");
        }
        // 可选：添加重连逻辑
        await Task.Delay(5000);
        await hubConnection.StartAsync();
    }
});

通过捕获的异常信息，可快速定位是路由错误、认证失败还是网络问题。

4. 检查后端Hub路由与注册 #

确认Program.cs中SignalR的注册和路由配置正确：

// 注册SignalR服务
builder.Services.AddSignalR();

// 映射Hub路由（需与前端URL匹配）
app.MapHub<OrderHub>("/orderHub");

确保前端TokenEndpoints.RegisterAlertEndPoint指向的地址为https://your-app-service.azurewebsites.net/orderHub，无拼写错误。

5. 查看Azure App Service日志 #

开启并查看服务日志，获取后端连接细节：

• 进入Azure App Service控制台 → 设置 > 监控 > 应用服务日志
• 开启「文件系统日志」，设置日志级别为「Information」或「Debug」
• 查看日志中是否有New connection或connection Disconnected的记录，确认连接是否到达后端；若有错误日志，可直接定位问题根源。

6. 免费层特殊限制排查 #

免费层的以下限制可能导致连接失败：

• 实例休眠：应用闲置20分钟后会自动休眠，首次请求需冷启动，可能导致连接超时。测试前先手动访问API URL唤醒服务。
• 带宽限制：免费层每月仅提供1GB出站带宽，若超出会限制流量，但单人测试场景极少触发。

7. 直接测试WebSocket连接 #

使用wscat工具测试WebSocket连接是否正常：

wscat -c "wss://your-app-service.azurewebsites.net/orderHub?userId=test&companyKy=test"

若连接失败，工具会返回具体错误码（如404=路由错误、403=CORS/认证问题、500=服务器内部错误），快速缩小排查范围。

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