SignalR WebSocket无法接收消息，JobProgressHub.AssociateJob未调用问题

常见触发失败原因及修复方式 #

• 连接未就绪就调用方法
  需等待SignalR客户端连接完全建立后再发起服务端方法调用，必须在connection.start()的Promise完成回调（或await等待返回后）执行invoke操作，连接建立过程中发起的调用会直接丢失。
• 方法名大小写不匹配
  SignalR默认启用驼峰命名转换，服务端C#的AssociateJob方法，客户端调用时需使用小写开头的associateJob，如果客户端写为invoke('AssociateJob')会无法匹配服务端方法。如果需要保留大小写一致的调用规则，可在服务端SignalR配置中禁用命名转换：

  builder.Services.AddSignalR()
    .AddJsonProtocol(options => 
    {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });
  

• 参数不匹配
  检查客户端调用时传入的参数数量、数据类型是否和服务端AssociateJob方法的定义完全一致，参数缺失、类型不匹配、传值为undefined都会导致服务端方法匹配失败。
• Hub路由配置错误
  确认服务端路由配置中JobProgressHub的映射路径和客户端初始化连接时填写的路径完全一致，路径不匹配会导致无法连接到对应Hub实例，自然无法触发方法。
• 跨域策略配置异常
  前后端端口/域名不一致时，服务端必须配置允许Credentials的CORS策略，不能使用AllowAnyOrigin()，需明确指定允许的前端域名，否则SignalR连接会被跨域策略拦截。

问题排查辅助手段 #

开启SignalR日志可以快速定位具体错误原因：

• 客户端日志：初始化连接时配置日志级别即可输出调用相关报错

  const connection = new signalR.HubConnectionBuilder()
    .withUrl("/jobProgressHub", { logger: signalR.LogLevel.Information })
    .build();
  

• 服务端日志：在appsettings.json中调整SignalR相关日志级别为Debug，即可查看方法匹配、连接建立相关的详细报错。

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