Blazor SignalR切换HTTPS后WebSocket握手失败及CORS问题求助

1. 修正CORS配置（适配HTTPS源） #

• 必须确保CORS策略包含HTTPS前端域名，不能仅配置HTTP地址。以ASP.NET Core为例，要将HTTPS前端地址加入允许列表，同时开启凭证支持（SignalR必需）：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("SignalRCorsPolicy", policy =>
      {
          policy.WithOrigins("https://your-frontend-domain") // 替换为实际HTTPS前端地址
                .AllowAnyHeader()
                .AllowAnyMethod()
                .AllowCredentials();
      });
  });
  
  // 注意：UseCors必须放在UseRouting和UseEndpoints之间
  app.UseCors("SignalRCorsPolicy");
  

• 验证方式：打开浏览器开发者工具的Network面板，查看SignalR请求的响应头，确认存在Access-Control-Allow-Origin且值匹配你的HTTPS前端域名。

2. 修复WebSocket握手返回200的问题 #

该错误大多源于反向代理未正确转发WebSocket请求，或后端HTTPS端点配置错误，分场景处理：

Nginx反向代理场景 #

• 在对应location块中添加WebSocket支持配置：

  location /your-signalr-hub-path {
      proxy_pass https://your-backend-domain;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      proxy_set_header Host $host;
      proxy_cache_bypass $http_upgrade;
      # 若后端未配置CORS，可在此添加CORS头
      add_header Access-Control-Allow-Origin "https://your-frontend-domain" always;
      add_header Access-Control-Allow-Credentials "true" always;
  }
  

• 配置完成后重启Nginx生效。

IIS反向代理场景 #

• 先确认已安装WebSocket协议：打开IIS管理器 → 服务器 → 添加角色和功能 → Web服务器 → 应用程序开发 → 勾选WebSocket协议。
• 编辑反向代理规则：进入站点的URL重写模块，编辑现有规则，在「服务器变量」中添加：
  • HTTP_UPGRADE，值为{HTTP_UPGRADE}
  • HTTP_CONNECTION，值为{HTTP_CONNECTION}

后端SignalR配置场景 #

• 确保后端正确绑定HTTPS端口，示例配置：

  builder.WebHost.UseUrls("https://*:443", "http://*:80"); // 按需调整端口
  

• 若使用自定义证书，需确保证书有效并正确加载：

  builder.WebHost.UseKestrel(options =>
  {
      options.ListenAnyIP(443, listenOptions =>
      {
          listenOptions.UseHttps("your-certificate.pfx", "cert-password");
      });
  });
  

3. 调整前端SignalR连接配置 #

• 确保前端连接地址为HTTPS协议，避免混合HTTP/HTTPS资源：

  const connection = new signalR.HubConnectionBuilder()
      .withUrl("https://your-backend-domain/your-signalr-hub-path")
      .withAutomaticReconnect()
      .build();
  

4. 排查SSL证书与TLS版本 #

• 生产环境需使用受信任的SSL证书，测试环境若用自签证书，需在浏览器中手动信任该证书。
• 确认服务器启用了TLS 1.2及以上版本（SignalR依赖该版本），禁用过时的TLS 1.0/1.1。

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