创建SignalR聊天应用遇Uncaught TypeError错误求排查

这个错误我之前开发SignalR聊天应用时也踩过坑，大概率是服务端配置不完整、客户端脚本加载顺序错误或者Hub连接代码写错导致的，咱们一步步排查解决：

1. 先补全Startup.cs的SignalR配置 #

你贴的Startup代码不全，这是最常见的问题根源。SignalR需要正确注册路由才能让客户端找到Hub，完整的Startup配置应该是这样：

using Owin;
using Microsoft.Owin;
using Microsoft.AspNet.SignalR;

// 必须添加这个特性，指定Owin启动类
[assembly: OwinStartup(typeof(SignalRMVC.Startup))]
namespace SignalRMVC
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            // 注册SignalR的路由，这一步不能少！
            app.MapSignalR();
        }
    }
}

重点：

• 一定要加[assembly: OwinStartup(...)]特性，否则Owin找不到启动类
• Configuration方法里必须调用app.MapSignalR()来启用SignalR路由

2. 检查客户端脚本的加载顺序 #

SignalR依赖jQuery，而且脚本加载顺序绝对不能乱，必须按以下顺序引入：

<!-- 第一步：加载jQuery（版本建议用2.x或3.x，和SignalR版本兼容即可） -->
<script src="~/Scripts/jquery-3.6.0.min.js"></script>
<!-- 第二步：加载SignalR核心脚本 -->
<script src="~/Scripts/jquery.signalR-2.4.3.min.js"></script>
<!-- 第三步：加载自动生成的Hub代理脚本（这个路径是固定的，由SignalR动态生成） -->
<script src="/signalr/hubs"></script>

⚠️ 验证小技巧：直接在浏览器地址栏输入/signalr/hubs，如果能看到自动生成的JavaScript代理代码，说明服务端路由配置没问题；如果404，那就是Startup配置错了。

3. 修正客户端连接Hub的代码 #

客户端调用Hub时，要注意SignalR会把服务端Hub类名的首字母转成小写（比如ChatHub对应客户端的chatHub），正确的连接代码示例：

$(function () {
    // 获取Hub代理，这里的chatHub对应服务端的ChatHub
    var chat = $.connection.chatHub;

    // 定义客户端接收消息的方法，要和服务端调用的方法名一致
    chat.client.addNewMessageToPage = function (name, message) {
        // 把消息渲染到页面上，这里根据你的DOM结构调整
        $('#messageList').append(`<li><strong>${name}</strong>: ${message}</li>`);
    };

    // 启动SignalR连接
    $.connection.hub.start().done(function () {
        // 连接成功后绑定发送按钮事件
        $('#sendBtn').click(function () {
            var userName = $('#userNameInput').val();
            var messageContent = $('#messageInput').val();
            // 调用服务端Hub的Send方法
            chat.server.send(userName, messageContent);
            // 清空输入框
            $('#messageInput').val('').focus();
        });
    });
});

如果$.connection是undefined，那肯定是SignalR核心脚本没加载成功，先检查脚本路径是否正确。

4. 确认SignalR包版本一致 #

确保你通过NuGet安装的Microsoft.AspNet.SignalR包，服务端和客户端的版本完全一致（比如都是2.4.3），版本不匹配也会导致各种奇怪的错误。

内容的提问来源于stack exchange，提问作者Sumit Singh Shekhawat