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类注解写法:
对应的B类只需要保留原有的注解和方法即可,不需要额外调整。@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); } - 清理旧生成文件,重新执行代码生成流程
改完注解后,旧的.g.dart生成文件已经和最新的代码不匹配,需要先清理再重新生成:
生成完成后,可以打开对应的# 清理历史生成产物 dart run build_runner clean # 重新生成序列化代码,自动处理冲突文件 dart run build_runner build --delete-conflicting-outputs.g.dart文件,检查_$AToJson方法中对list字段的处理逻辑,正常的生成逻辑应该是这样的形式:
只要看到list字段的处理是通过map调用每个元素的Map<String, dynamic> _$AToJson(A instance) => <String, dynamic>{ 'name': instance.name, 'age': instance.age, 'list': instance.list?.map((e) => e.toJson())?.toList(), };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
相关产品推荐
相关产品推荐

