You need to enable JavaScript to run this app. Flutter/Dart使用@JsonSerializable时如何输出含嵌套对象的完整JSON
优惠活动
大模型
产品
解决方案
定价
更多

Flutter/Dart使用@JsonSerializable时如何输出含嵌套对象的完整JSON

核心问题排查与解决方案

问题根因

出现[instance of 'B']的输出,本质是json_serializable没有为A类里的List<B>字段生成正确的递归序列化逻辑,导致列表里的B实例没有被转换为Map结构,而是以原始对象形式存在。

分步调整方案(完全保留你现有的类结构,不需要重写字段和方法)

  • 修正代码中的语法笔误
    首先把代码里的Dart语法错误修正:
    • 将大写的类关键字Class B改回小写的class B
    • 给两个类的构造函数补上缺失的分号,保证语法可正常编译
  • 给A类的@JsonSerializable注解补充关键参数
    在所有配置中,explicitToJson: true是解决嵌套列表序列化失效的最核心参数。这个参数开启后,json_serializable生成的_$AToJson方法会自动遍历List<B>中的每一个B实例,主动调用每个B实例的toJson()方法生成Map结构,而不是直接把原始B实例塞进返回的Map中。
    调整后的A类注解写法:
    @JsonSerializable(explicitToJson: true)
    class A{
      String name;
      int age;
      List<B> list;
      A({this.name, this.age, this.list});
    
      Map<String, dynamic> toJson() => _$AToJson(this);
      factory A.fromJson(Map<String, dynamic> json) => _$AFromJson(json);
    }
    
    对应的B类只需要保留原有的注解和方法即可,不需要额外调整。
  • 清理旧生成文件,重新执行代码生成流程
    改完注解后,旧的.g.dart生成文件已经和最新的代码不匹配,需要先清理再重新生成:
    # 清理历史生成产物
    dart run build_runner clean
    # 重新生成序列化代码,自动处理冲突文件
    dart run build_runner build --delete-conflicting-outputs
    
    生成完成后,可以打开对应的.g.dart文件,检查_$AToJson方法中对list字段的处理逻辑,正常的生成逻辑应该是这样的形式:
    Map<String, dynamic> _$AToJson(A instance) => <String, dynamic>{
      'name': instance.name,
      'age': instance.age,
      'list': instance.list?.map((e) => e.toJson())?.toList(),
    };
    
    只要看到list字段的处理是通过map调用每个元素的toJson(),就说明序列化逻辑已经正确。
  • 打印阶段的优化
    当a.toJson()返回的Map中,list字段已经是Map元素构成的列表结构时,直接print这个Map就能看到完整的结构;如果需要输出标准的JSON字符串,可以配合dart:convert的jsonEncode使用:
    import 'dart:convert';
    print(jsonEncode(a.toJson()));
    

注意:不需要在A类中手动对list字段做循环转换,开启explicitToJson后,生成的代码会自动复用B类本身的序列化逻辑,完全符合你现有代码结构的设计。

内容的提问来源于stack exchange,提问作者Damandroid

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 17:15:04