使用jquery 3.3.1时SignalR客户端无法接收通知问题求助

问题根因 #

• API兼容问题：jQuery 3.x删除了1.x版本中存在的$.browser等过时API，虽然SignalR 2.4.2官方说明兼容jQuery 3.x，但如果你的项目中用到了服务端旧版本SignalR生成的自动代理脚本（/signalr/hubs），代理脚本仍会调用已删除的API，导致脚本执行中断，事件监听逻辑无法正常运行。
• 异步行为差异：jQuery 3.x重构了Deferred异步对象的实现，默认采用严格上下文绑定，和SignalR 2.4.2预期的回调上下文不一致，会导致连接建立成功后事件绑定失效。
• 语法校验差异：你提供的客户端代码中，prepend方法传入的字符串存在强制换行，jQuery 3.x对非法字符串拼接的校验更严格，会直接抛出语法错误，导致整个$(document).ready回调中断执行。

解决方案 #

• 调整脚本引入顺序，严格按照「jQuery 3.3.1 → jquery.signalR-2.4.2.js → 服务端生成的/signalr/hubs代理脚本」的顺序引入，顺序错误会直接导致SignalR初始化失败。
• 修复客户端代码中的非法换行字符串，把prepend方法中换行的文本合并为单行，避免语法校验报错：

// 调整前的错误写法
.prepend("<i>sendupdate</i> event is being listened 
        !")
// 调整后的正确写法
.prepend("<i>sendupdate</i> event is being listened !")

• 手动添加兼容配置，适配jQuery 3.x的Deferred行为，在调用start()方法前添加如下代码：

$.ajaxSetup({
  xhrFields: {
    withCredentials: true
  }
});

• 如果上述方案都无法解决问题，可以替换为无jQuery依赖的SignalR客户端包@microsoft/signalr，该版本完全脱离jQuery依赖，不会出现版本兼容问题，仅需要调整少量客户端初始化代码即可。

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