如何捕获ASP.NET SignalR Hub的MissingMethodException异常？

一、确认Hub端点配置是否正确 #

客户端连接地址是https://localhost:7263/chathub，必须确保服务器端在Program.cs中正确映射该端点：

// 注册SignalR服务
builder.Services.AddSignalR();

// 映射Hub端点
app.MapHub<MessageHub>("/chathub");

如果端点路径不匹配，客户端连接的是错误Hub，自然找不到对应方法。

二、确保Hub方法签名完全匹配 #

SignalR默认对方法名大小写不敏感，但参数的数量、类型必须完全一致：

• 服务器端SendMessage接收1个string类型参数，客户端调用时传递的参数类型也必须是字符串（你的代码传"Test"符合要求）。
• 检查服务器端是否存在同名但不同签名的重载方法，这可能导致方法匹配失败。

三、正确捕获客户端与服务器端异常 #

客户端异常捕获 #

改用try-catch结构能更清晰处理错误，同时打印完整错误信息：

async function sendMessage(msg) {
    console.log("Attempting send: ", msg);
    if (connection.state === "Connected") {
        try {
            let res = await connection.invoke("SendMessage", msg);
            console.log("发送成功", res);
        } catch (err) {
            console.error("发送错误详情:", err);
            // 可在此添加用户提示逻辑
        }
    }
}

服务器端异常处理 #

服务器端未处理的异常会直接断开连接，需在Hub方法内部捕获异常，避免向上抛出：

using Microsoft.AspNetCore.SignalR;

namespace GCGSite.Server
{
    public class MessageHub : Hub
    {
        public async Task SendMessage(string message)
        {
            try
            {
                await Clients.All.SendAsync("ReceiveMessage", message);
            }
            catch (Exception ex)
            {
                // 记录异常日志
                // 可选：向调用者返回错误信息
                await Clients.Caller.SendAsync("SendMessageFailed", ex.Message);
                // 不要抛出异常，防止连接中断
            }
        }
    }
}

四、启用服务器端日志排查问题 #

在appsettings.json中添加SignalR相关日志配置，查看服务器端详细错误信息，确认具体是哪个方法找不到：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.SignalR": "Debug",
      "Microsoft.AspNetCore.Http.Connections": "Debug"
    }
  }
}

启动服务器后，日志会输出方法匹配的详细过程，帮你定位问题根源。

五、检查版本兼容性 #

确保客户端使用的@microsoft/signalr版本与服务器端的Microsoft.AspNetCore.SignalR版本一致，版本不兼容可能导致协议解析错误，引发方法匹配失败。

六、验证CORS配置（跨域场景） #

如果客户端和服务器端跨域部署，需确保CORS配置允许SignalR的请求类型：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowAll", policy =>
    {
        policy.WithOrigins("你的客户端域名")
              .AllowAnyHeader()
              .AllowAnyMethod()
              .AllowCredentials(); // SignalR需要启用Credentials
    });
});

app.UseCors("AllowAll");

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