SignalR Hub调用Blazor客户端方法时参数传递异常问题

可能的原因及排查步骤 #

• 检查Game类的序列化配置
  SignalR默认使用System.Text.Json序列化对象，若Game类中的_gameBoard是私有字段，序列化器可能无法正确读取并传递该值。解决方式：

  • 将_gameBoard改为公共属性：

    public char[] GameBoard { get; set; }
    

  • 若保留私有字段，需添加序列化标记确保能被读取：

    [JsonPropertyName("gameBoard")]
    private char[] _gameBoard;
    

• 验证Hub发送对象的完整性
  在Hub的MakeMove方法中，发送给客户端前再次确认game._gameBoard的状态，确保发送的是更新后的最新对象，而非未修改的缓存实例。可以临时添加控制台输出验证：

  public async Task MakeMove(...)
  {
      // 更新game逻辑...
      Console.WriteLine($"Sending GameBoard[0]: {game._gameBoard[0]}");
      await Clients.All.SendAsync("RenderGame", game);
  }
  

• 排查客户端反序列化与接收逻辑
  在Blazor客户端的RenderGame方法中，接收参数后立即打印game的对应值，确认是反序列化丢失数据还是后续逻辑覆盖：

  public async Task RenderGame(Game game)
  {
      Console.WriteLine($"Received GameBoard[0]: {game.GameBoard[0]}");
      // 后续渲染逻辑...
      StateHasChanged();
  }
  

• 确认Blazor组件状态更新
  若接收的值正确但渲染时不显示，需确保在接收数据后调用StateHasChanged()通知组件重新渲染，且组件模板正确绑定了GameBoard的对应值：

  @for (int i = 0; i < Game.GameBoard.Length; i++)
  {
      <button @onclick="() => MakeMove(i)">@Game.GameBoard[i]</button>
  }
  

• 查看WebSocket消息内容
  使用浏览器开发者工具（Network面板 -> WebSocket），查看SignalR传递的消息payload，确认后端发送的gameBoard字段是否包含正确的X值，以此区分问题出在后端发送还是客户端接收环节。

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