.NET Web应用SignalR报错：Cannot read property 'client' of undefined

嘿，这个错误我之前折腾SignalR的时候也碰到过，核心原因基本都是SignalR的Hub连接对象没有被正确初始化，要么是脚本漏加载了，要么是后端配置没到位。结合你的情况，给你梳理几个必查的点：

1. 确认SignalR脚本的完整性与加载顺序 #

你已经确认jQuery先加载了，这步没错，但还要注意两个关键点：

• 首先，BundleConfig里要确保包含完整的SignalR核心脚本，比如：

bundles.Add(new ScriptBundle("~/bundles/signalr").Include(
    "~/Scripts/jquery.signalR-{version}.js"));

• 其次，必须在页面中引用动态生成的SignalR Hub代理脚本——也就是~/signalr/hubs，而且这个脚本要放在jquery.signalR.js之后加载。比如在你的_Layout.cshtml或者页面里加：

<script src="~/bundles/signalr"></script>
<script src="~/signalr/hubs"></script>

这个代理脚本是SignalR根据你后端的Hub类自动生成的，没有它，客户端根本找不到对应的Hub对象，自然会报client属性未定义。

2. 检查后端Hub类的定义是否规范 #

后端的Hub类必须满足两个要求：

• 继承自Microsoft.AspNet.SignalR.Hub（.NET Framework）或者Microsoft.AspNetCore.SignalR.Hub（.NET Core）；
• 类名要和客户端调用的名称对应——SignalR会自动把后端的 PascalCase 类名转成客户端的 camelCase。比如你后端的Hub类叫ChatHub，客户端要写$.connection.chatHub（小写开头的chatHub），别写错大小写了。

3. 确认SignalR的路由配置是否生效 #

这步很容易被忽略：

• 如果你用的是.NET Framework，要在Global.asax的Application_Start方法里添加SignalR路由注册：

protected void Application_Start()
{
    // 其他配置...
    RouteTable.Routes.MapHubs();
}

• 如果是.NET Core，要在Startup.cs里配置SignalR服务和路由：

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR();
    // 其他服务配置...
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中间件...
    app.UseSignalR(routes =>
    {
        routes.MapHub<ChatHub>("/chatHub"); // 这里的路径要和客户端对应
    });
}

没有正确注册路由，前端也无法获取到Hub代理脚本。

4. 确保客户端初始化代码的时机正确 #

别着急在页面刚加载就初始化SignalR，要等所有脚本都加载完成。把你的客户端代码放在jQuery的DOM就绪事件里，比如：

$(function () {
    // 先检查Hub对象是否存在
    if ($.connection && $.connection.chatHub) {
        var chatHub = $.connection.chatHub;
        
        // 定义客户端接收方法
        chatHub.client.receiveMessage = function (message) {
            // 处理收到的消息
            console.log("收到消息：" + message);
        };
        
        // 启动连接
        $.connection.hub.start()
            .done(function () {
                console.log("SignalR连接成功！");
            })
            .fail(function (err) {
                console.error("连接失败：" + err);
            });
    } else {
        console.error("未找到SignalR Hub代理，请检查脚本加载！");
    }
});

按照上面的步骤排查，大概率能解决这个问题——我当时就是漏加了~/signalr/hubs脚本，折腾了好一会儿才发现。

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