.NET 5 SignalR本地正常 部署IIS 10后客户端调用Hub方法失效

排查步骤与解决方案 #

1 修复事件注册顺序错误 #

当前所有SignalR连接都将connection.on事件注册放在connection.start的回调中，会导致连接建立完成后收到的消息无法被未注册的事件捕获，这是收不到NovoPedido通知的核心原因之一。
所有端的SignalR初始化代码都要调整为先注册事件，再启动连接，以仪表板端代码为例：

// 先注册事件
connection.on('NovoPedido', function (idPedido) {
    if (idPedido > 0) {
        atualizaPedidos();
    }
});
// 再启动连接
connection.start()
    .then(function () {
        console.log("连接建立成功");
    })
    .catch(err => console.error("连接失败：", err));

2 修复invoke调用后立即跳转的逻辑 #

第三段JS代码中调用connection.invoke后立即执行页面跳转，invoke是异步方法，还没完成请求发送页面就已经卸载，导致调用根本没有到达服务器。修改跳转逻辑，等待invoke执行完成后再跳转：

connection.start()
    .then(function () {
        // 等待invoke执行完成
        return connection.invoke("AtualizaDashBoad", data.idPedido);
    })
    .then(() => {
        // 调用成功后再跳转
        window.location.href = "/app/pedido/pedido?idPedido=" + data.idPedido;
    })
    .catch(err => {
        console.error("调用AtualizaDashBoad失败：", err);
        // 此处可添加错误提示逻辑
    });

3 完善IIS与CORS配置 #

• 打开IIS管理器，进入对应站点的「功能视图」，找到「WebSocket」选项，确认状态为已启用
• 检查项目根目录的Web.config，确认没有<webSocket enabled="false" />配置，如有则删除或改为true
• 完善Startup.cs中的CORS配置，允许SignalR所需的请求头与方法：

services.AddCors(options =>
{
    options.AddDefaultPolicy(builder =>
    {
        builder.WithOrigins("https://mydomain")
            .AllowAnyHeader()
            .AllowAnyMethod()
            .AllowCredentials();
    });
});

4 替换C#端Hub调用方式 #

当前C#代码每次发送消息都新建Hub连接，效率低且容易出现连接异常，改用注入IHubContext的方式直接调用Hub方法，无需新建连接：

// 控制器构造函数注入IHubContext
private readonly IHubContext<PedidoHub> _hubContext;
public 你的控制器名称(IHubContext<PedidoHub> hubContext)
{
    _hubContext = hubContext;
}

// 改造发送消息方法
private async Task EnviarMsgHubTracker(int status)
{
    await _hubContext.Clients.All.SendAsync("GetStatusPedido", status);
}

5 开启详细日志定位问题 #

如果以上修改后仍有问题，开启前后端的SignalR详细日志排查具体错误：

• 前端将日志级别调整为Debug：

.configureLogging(signalR.LogLevel.Debug)

• 后端appsettings.json添加日志配置：

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

查看浏览器控制台与后端日志，确认AtualizaDashBoad请求是否正常到达服务器，是否存在权限、参数错误等问题。

额外检查项 #

确认代码中的WebSocket连接地址没有笔误，正确的安全WebSocket协议前缀是wss://，不是你日志里写的wws://，如果实际配置中存在该笔误请修正。

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