Azure SignalR Service无法作为WebSocket连接使用问题求助

关键排查项 #

• 端点切换
  迁移到Azure SignalR后，客户端不能直接连接原自托管端点wss://example.com/chat-hub。Azure SignalR会提供专属服务端点（格式为wss://<你的SignalR服务名>.service.signalr.net/client/?hub=chat-hub），客户端需通过应用服务器的negotiate接口获取该端点，而非直接硬编码原地址。
• 连接字符串验证
  确认ASP.NET Core应用配置文件中Azure SignalR连接字符串正确，格式为Endpoint=https://<服务名>.service.signalr.net;AccessKey=<主/辅助密钥>;Version=1.0;，密钥需从Azure门户SignalR服务的密钥页面获取。
• CORS双端配置
  若Flutter Web为跨域访问，需同时配置：
  • ASP.NET Core中添加允许Flutter Web域名的CORS策略；
  • Azure门户SignalR服务→设置→CORS中添加该域名。
• SignalR中间件配置
  确保Program.cs/Startup.cs中正确启用Azure SignalR：

  // .NET 6+ 示例
  builder.Services.AddSignalR().AddAzureSignalR();
  app.MapHub<ChatHub>("/chat-hub");
  

  遗漏AddAzureSignalR()会导致应用仍以自托管模式运行，无法对接Azure服务。
• Postman测试流程修正
  Postman不能直接连接原WebSocket端点，需先发送GET请求到https://example.com/chat-hub/negotiate获取url和accessToken，再用返回的url建立WebSocket连接，并在请求头添加Authorization: Bearer <accessToken>，最后发送初始化帧{"protocol":"json","version":1}完成握手。
• 服务配额检查
  免费层Azure SignalR有连接数限制，可在Azure门户查看服务监控指标（连接数、错误日志），确认是否因配额耗尽导致连接失败。

Flutter Web客户端适配示例 #

原自托管连接代码需调整为通过negotiate接口获取连接信息：

// 先调用negotiate接口获取Azure SignalR连接参数
var negotiateResp = await http.get(Uri.parse('https://example.com/chat-hub/negotiate'));
var negotiateData = jsonDecode(negotiateResp.body);

// 构建Hub连接
var hubConn = HubConnectionBuilder()
    .withUrl(negotiateData['url'], options: HttpConnectionOptions(
      accessTokenFactory: () async => negotiateData['accessToken'],
    ))
    .build();

内容的提问来源于stack exchange，提问作者Yasir Arefin Tusher