SignalR调用带参方法时参数绑定失败的原因排查

问题原因 #

报错提示Error binding arguments，核心原因是客户端与服务器端的JSON序列化器不兼容，导致整数参数的类型解析不匹配。ASP.NET Core SignalR默认使用System.Text.Json序列化，而旧版.NET SignalR客户端（如.NET Framework环境下的WPF）默认使用Newtonsoft.Json，两者对整数类型的序列化/反序列化逻辑存在差异——客户端传递的int类型参数，可能被服务器端解析为long，无法匹配Ding方法的int x参数，最终触发绑定错误。

解决方法 #

方法1：统一序列化协议 #

让服务器和客户端使用相同的JSON序列化器，消除类型解析差异：

服务器端配置Newtonsoft.Json（适配旧客户端）

在ASP.NET Core项目的Program.cs中，修改SignalR服务配置，启用Newtonsoft.Json协议：

// 先安装NuGet包：Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson
builder.Services.AddSignalR()
    .AddNewtonsoftJsonProtocol();

客户端配置System.Text.Json（适配新版服务器）

如果你的WPF项目基于.NET Core/.NET 5+，初始化HubConnection时指定使用System.Text.Json协议：

var connection = new HubConnectionBuilder()
    .WithUrl("http://your-server-url/chathub")
    .AddJsonProtocol(options =>
    {
        options.PayloadSerializerOptions.PropertyNameCaseInsensitive = true;
    })
    .Build();

方法2：修改服务器端参数类型 #

如果不想调整序列化配置，可直接修改服务器端Ding方法的参数类型为long，兼容客户端传递的整数类型：

public async Task Ding(long x)
{
    logger.LogInformation($"Ding! {x}");
    await Clients.Caller.SendAsync("Dong");
}

额外优化：避免UI线程死锁 #

当前代码使用.Wait()同步调用异步方法，在WPF UI线程中可能引发死锁，建议改用await异步调用：

private async void TEST_button_Click(object sender, RoutedEventArgs e)
{
    if (Global.SignalR != null)
    {
        await Global.SignalR.InvokeAsync("Ping");
        await Global.SignalR.InvokeAsync("Ding", 123);
    }
}

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