Blazor WebAssembly使用SignalR传输复杂对象通信失败如何解决？

首先解答你的几个核心疑问：

1. JSON本身完全支持嵌套对象、二维数组、字典结构，你遇到的传输失效问题是*SignalR默认使用的System.Text.Json序列化器默认配置不支持你的复杂类型特性（继承多态、循环引用、非字符串键字典等）*导致的，和JSON协议本身无关。
2. Server-side Blazor能正常传输复杂结构和Websocket协议无关，是因为Server-side Blazor内部使用的SignalR通道做了专属的序列化配置，且服务端和交互端都运行在.NET环境中，序列化上下文完全一致；而Blazor WebAssembly运行在浏览器的.NET runtime中，默认序列化配置和Server侧不一致，才会出现解析失败的问题。
3. 无法直接复用Server-side Blazor的内部通信机制，该机制是绑定Server侧渲染Circuit的专属通道，不适合用于WASM的业务数据传输，但你只需要调整现有SignalR的配置就能满足需求，无需更换通信方案。

具体修复步骤 #

1. 先修复代码的低级错误 #

你服务端OnLogin方法声明需要接收string gameId参数，但客户端调用SendAsync("OnLogin")时没有传递参数，这会直接导致Hub方法调用失败，优先修正。

2. 配置JSON序列化规则适配复杂类型 #

需要在服务端和客户端保持完全一致的System.Text.Json序列化配置，适配继承、循环引用、字典等结构：

服务端配置（Program.cs）

// 注册SignalR时配置JSON序列化规则
builder.Services.AddSignalR()
    .AddJsonProtocol(options =>
    {
        // 允许循环引用处理
        options.PayloadSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        // 支持非字符串类型的字典键序列化
        options.PayloadSerializerOptions.DictionaryKeyPolicy = JsonNamingPolicy.CamelCase;
        // 注册源生成的序列化上下文（避免WASM环境反射序列化失败）
        options.PayloadSerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
    });

复杂类型标记与序列化上下文声明

对所有需要传输的基类加[JsonDerivedType]标记支持多态序列化：

// 示例：给基类标记所有子类的鉴别器
[JsonDerivedType(typeof(Player), typeDiscriminator: "player")]
[JsonDerivedType(typeof(GameItem), typeDiscriminator: "gameItem")]
public class BaseGameObject { }

// 声明源生成序列化上下文，包含所有需要传输的类型
[JsonSerializable(typeof(Gvars))]
[JsonSerializable(typeof(Player))]
// 所有用到的复杂类型都要在这里注册
public partial class AppJsonSerializerContext : JsonSerializerContext { }

Blazor WASM客户端配置

创建Hub连接时同步配置序列化规则：

hubConnection = new HubConnectionBuilder()
    .WithUrl(NavigationManager.ToAbsoluteUri("/myhub"))
    .AddJsonProtocol(options =>
    {
        // 和服务端配置完全一致
        options.PayloadSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        options.PayloadSerializerOptions.DictionaryKeyPolicy = JsonNamingPolicy.CamelCase;
        options.PayloadSerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
    })
    .Build();

3. 高性能方案：更换为MessagePack协议 #

如果需要更适合游戏的高速、低体积传输，可直接更换SignalR的传输协议为MessagePack，无需修改业务代码：

1. 服务端安装NuGet包Microsoft.AspNetCore.SignalR.Protocols.MessagePack，注册时开启：

builder.Services.AddSignalR()
    .AddMessagePackProtocol(options =>
    {
        // 可自定义序列化规则，默认就支持继承、嵌套、字典等结构
    });

2. 客户端安装相同版本的Microsoft.AspNetCore.SignalR.Protocols.MessagePack包，创建Hub连接时开启：

hubConnection = new HubConnectionBuilder()
    .WithUrl(NavigationManager.ToAbsoluteUri("/myhub"))
    .AddMessagePackProtocol()
    .Build();

MessagePack的序列化性能、传输体积都远优于JSON，非常适合在线游戏的通信场景。

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