SignalR客户端连接SignalRHub失败，报404错误求助

根据你提供的错误日志，核心问题是WebSocket传输启动时收到了404响应，说明客户端请求的Hub端点在服务器上找不到。我整理了几个常见的排查方向和解决办法，都是实际开发中踩过的坑：

1. 先确认Hub的路径是否完全匹配 #

服务器端配置Hub路由时的路径，必须和客户端连接的URL完全一致，差一个字符都不行。

比如服务器端是这么配置的：

app.MapHub<MyChatHub>("/chatHub");

那客户端的连接代码就得对应：

var connection = new HubConnectionBuilder()
    .WithUrl("http://localhost:5000/chatHub") // 这里的路径必须和服务器端一致
    .Build();

如果客户端写成了/chat或者/hubs/chatHub，直接就会404。

2. 检查服务器端中间件的顺序 #

SignalR的Hub映射必须放在正确的中间件顺序里，这是很多人容易忽略的点：

• 必须在app.UseRouting()之后，app.UseEndpoints()内部配置Hub映射
• 同时UseCors（如果有跨域需求）要放在UseRouting之前

正确的示例：

// 先配置CORS（如果需要）
app.UseCors("AllowSignalRCors");

app.UseRouting();
app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<MyChatHub>("/chatHub"); // 这里配置Hub
    endpoints.MapControllers();
});

如果把Hub映射放在UseEndpoints外面，或者顺序搞反，服务器就找不到这个端点。

3. IIS部署时要启用WebSocket协议 #

如果你的SignalR服务器部署在IIS上，默认WebSocket协议是关闭的，这会直接导致WebSocket传输失败：

1. 打开「控制面板」→「程序」→「启用或关闭Windows功能」
2. 找到「Internet信息服务」→「万维网服务」→「应用程序开发功能」
3. 勾选「WebSocket协议」，点击确定安装

安装完成后重启IIS，再试试连接。

4. 跨域场景下检查CORS配置 #

如果客户端和服务器不在同一个域名下，CORS配置必须满足SignalR的要求：

• 必须允许客户端的Origin
• 必须启用AllowCredentials()（SignalR需要携带认证信息或Cookie）
• 允许SignalR需要的头部和方法

示例配置：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowSignalRCors", policy =>
    {
        policy.WithOrigins("http://your-client-app.com")
              .AllowAnyHeader()
              .AllowAnyMethod()
              .AllowCredentials();
    });
});

然后在中间件里调用app.UseCors("AllowSignalRCors")，位置一定要在UseRouting之前。

5. 验证Hub端点是否存在 #

最简单的验证方法：在浏览器里直接访问你的Hub地址，比如http://localhost:5000/chatHub。

• 如果页面返回「Connection ID required」，说明Hub端点是正常存在的，问题出在客户端连接逻辑或者传输配置上
• 如果直接返回404，那肯定是服务器端的Hub路由配置有问题，回到第一步重新检查

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