.NET Core 3.1环境下SignalR无代码变更却立即断开连接问题求助

1. 路由大小写匹配问题 #

服务端终结点配置的Hub路由是/lmhub（全小写），但前端withUrl传入的是/lmHub（第二个字母大写），ASP.NET Core 3.0+默认开启路由大小写敏感匹配，会导致连接建立后服务端找不到对应的Hub实例直接主动断开连接，返回的状态码就是无额外提示的1000。

• 解决方法：将前端连接地址修改为和服务端完全一致的/lmhub，也可以在路由配置中关闭大小写敏感：

services.AddRouting(options => options.LowercaseUrls = false);

2. 心跳配置错误 #

你在SignalR配置和WebSocket中间件配置中，都将KeepAliveInterval设置为了TimeSpan.Zero，该配置不符合SignalR的设计要求：心跳间隔为零会导致服务端心跳发送逻辑异常，服务端会判定连接无响应直接主动断开，且默认不会输出错误日志。

• 解决方法：将两处KeepAliveInterval恢复为合理区间（建议15~30秒）即可：

// SignalR配置
services.AddSignalR(options =>
{
    options.KeepAliveInterval = TimeSpan.FromSeconds(15);
});
// WebSocket中间件配置
var webSocketOptions = new WebSocketOptions()
{
    KeepAliveInterval = TimeSpan.FromSeconds(30),
};

3. Hub依赖注入异常 #

如果你的LiquidMeterHub构造函数中注入了无法正常初始化的服务，即使Hub代码看起来是标准样板代码，服务端在连接建立后初始化Hub实例失败，也会直接断开连接，且默认不会将详细错误返回给前端。

• 解决方法：开启SignalR详细错误日志，在AddSignalR配置中添加参数：

services.AddSignalR(options =>
{
    options.EnableDetailedErrors = true;
});

同时将前端日志级别调整为Trace获取更完整的连接日志：

.configureLogging(signalR.LogLevel.Trace)

4. 中间件路由冲突 #

可额外检查是否有其他自定义中间件在UseRouting之前拦截了WebSocket请求，或者存在和Hub路由冲突的静态资源规则，这类拦截也会触发服务端主动正常断开连接。

5. 前后端版本不匹配 #

即使回滚了代码，也可能存在前端SignalR TS包版本和服务端SignalR NuGet包版本不一致的情况，跨大版本的不兼容会导致连接建立后握手逻辑异常直接断开。

• 解决方法：确认前端@microsoft/signalr包版本和服务端Microsoft.AspNetCore.SignalRNuGet包的主版本号完全一致。

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