如何排查Blazor WebAssembly中“Expected BEGIN-OBJECT but was string”错误？

以下是针对你遇到的问题的实用排查建议：

• 先获取原始响应内容，对比实际数据
  暂时替换GetFromJsonAsync，先拿到API返回的原始JSON字符串，再手动反序列化，这样能确认客户端实际收到的内容和Swagger显示的是否一致。示例代码：

  var response = await Http.GetAsync("你的API接口地址");
  var rawJson = await response.Content.ReadAsStringAsync();
  Console.WriteLine("原始响应JSON: " + rawJson); // 输出到浏览器控制台查看
  try
  {
      var data = System.Text.Json.JsonSerializer.Deserialize<List<你的实体类>>(rawJson);
  }
  catch (System.Text.Json.JsonException ex)
  {
      Console.WriteLine($"反序列化错误详情: {ex.Message}");
  }
  

  很多时候问题出在中间环节（比如代理、响应拦截器）修改了JSON内容，或者API返回的实际数据和Swagger展示的不一致。

• 检查实体模型与JSON字段的匹配性
  即使Swagger的JSON看起来正常，也可能存在模型定义问题：

  • 某个属性类型不匹配：比如JSON里是字符串，但模型里定义为int/对象类型
  • 字段名大小写不兼容：如果JSON用小驼峰（如userName），模型用大驼峰（如UserName），需确保序列化配置开启了PropertyNameCaseInsensitive
  • 嵌套结构错误：模型里定义为对象，但JSON返回的是转义后的字符串（比如本该是{"id":1}，实际返回"{\"id\":1}"）

• 排查EF Core生成数据的潜在问题
  因为是EF Core填充本地SQL数据，可能存在：

  • 数据库字段存储了JSON格式的字符串（而非原生JSON类型），API返回时被当作普通字符串输出，导致反序列化失败
  • 实体类的导航属性未正确配置，序列化时出现循环引用，被框架处理成异常字符串（如$ref标记）

• 确认HTTP响应的Content-Type
  检查API返回的响应头中Content-Type是否为application/json，如果是text/plain或其他类型，GetFromJsonAsync可能会出现解析异常，可手动指定序列化选项或修正API的响应头设置。

• 修复日志捕获问题
  确保异常被正确捕获并输出：

  • 在Blazor组件的异步生命周期方法（如OnInitializedAsync）中，用try-catch包裹服务调用代码，并用Console.WriteLine输出异常详情（浏览器F12控制台可查看）
  • 在Program.cs中提升日志级别，获取更详细的调试信息：

    builder.Logging.SetMinimumLevel(LogLevel.Debug);
    

• 隔离MudBlazor的影响
  先跳过MudBlazor表格渲染，直接在组件中输出反序列化后的列表数量或字段值，确认数据是否正确加载。如果数据正常，再逐步引入表格渲染，排查是否是表格绑定的属性类型不匹配或字段名错误导致的间接异常。

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