SignalR握手取消错误求助：首次使用WebSocket遇问题

• 检查WebSocket协议支持情况：部分宿主环境需手动启用WebSocket功能。Windows系统可通过「控制面板→程序→启用或关闭Windows功能→Internet信息服务→万维网服务→应用程序开发功能→WebSocket协议」开启；Linux部署时，确认Nginx等服务器配置中允许WebSocket转发，需添加Upgrade和Connection头的相关配置。

• 确保客户端与服务端版本完全匹配：尽管已更新至最新版，仍要确认前端@microsoft/signalr包和服务端Microsoft.AspNetCore.SignalR NuGet包的版本号完全一致，小版本号也需对齐，版本不兼容是握手失败的常见诱因。

• 验证跨域（CORS）配置正确性：若前端与服务端跨域，需在服务端Startup/Program.cs中配置允许SignalR的跨域请求，确保允许的Origin、Headers、Methods包含SignalR所需内容，示例配置如下：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowAll", policy =>
    {
        policy.WithOrigins("你的前端域名")
              .AllowAnyHeader()
              .AllowAnyMethod()
              .AllowCredentials();
    });
});
app.UseCors("AllowAll");
app.MapHub<YourHub>("/yourHubPath").RequireCors("AllowAll");

• 排查网络拦截因素：本地开发时，代理工具（如Fiddler）、防火墙可能拦截WebSocket握手请求，可尝试关闭相关工具后重试；生产环境需确认服务器防火墙开放了WebSocket对应的端口（默认与HTTP/HTTPS端口一致，即80/443）。

• 查看详细错误日志：在服务端启用SignalR调试日志，修改配置文件添加：

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

运行后查看日志，可获取握手取消的具体触发原因，比如请求头错误、路径不匹配等。

• 确认Hub路径一致性：客户端连接时的路径需与服务端MapHub配置的路径完全一致，例如服务端配置为app.MapHub<ChatHub>("/chatHub")，客户端连接代码需写为const connection = new signalR.HubConnectionBuilder().withUrl("/chatHub").build();，注意避免路径中斜杠多写或漏写。

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