如何基于嵌套POJO类以最少代码高效构建复杂层级的嵌套JSON响应？

优先选择：序列化框架直接映射（零冗余开发） #

不管是Spring Boot默认集成的Jackson，还是Google的Gson，都能直接把嵌套POJO的完整结构自动序列化成对应层级的JSON，根本不需要手动逐字段拼接。
具体实现逻辑：

• 如果POJO的字段名和要输出的JSON字段名完全一致：直接调用序列化API即可，比如Jackson调用objectMapper.writeValueAsString(accountInstance)、Gson调用new Gson().toJson(accountInstance)，就能把包含sim、device、line嵌套属性的Account对象，完整转成对应结构的JSON，一行额外转换代码都不用写。
• 如果字段名和目标JSON存在差异、需要排除部分字段，直接在POJO属性上加注解就能完成映射，不需要写任何转换逻辑：
  • Jackson用@JsonProperty("目标字段名")完成不同名字段的映射，用@JsonIgnore标记不需要输出的字段
  • Gson用@SerializedName("目标字段名")完成字段映射
  • 通用控制：可以用Jackson的@JsonInclude(JsonInclude.Include.NON_NULL)控制空值字段不输出，减少冗余内容

基础POJO示例（配合Lombok可以省掉所有get/set冗余代码）

@Data
public class Account {
    private Sim sim;
    private Device device;
    private Line line;
}

@Data
public class Sim {
    private String iccid;
    private String msisdn;
}
// Device、Line类结构同理，都是嵌套的POJO属性

这种方式的序列化效率是经过超大规模生产场景验证的，比手动拼字符串的效率高一个量级，还完全避免了拼接JSON时容易出现的语法错误（漏逗号、引号、特殊字符转义问题）。

结构差异较大时的低编码实现 #

如果现有POJO的层级和目标JSON的层级不匹配（比如需要把Account的属性拆分到不同的目标JSON层级、合并其他来源的字段），也不需要硬写嵌套JSON字符串：

• 用Jackson树模型组装，完全规避JSON语法错误。树模型的API会自动处理所有JSON语法规则，不管嵌套多少层，都不会出现少括号、少引号的问题，代码写起来和操作普通Java对象一样顺：

  // 直接复用项目全局配置的ObjectMapper实例，不要自己new
  ObjectNode rootNode = objectMapper.createObjectNode();
  // 直接把整个Account对象转成树节点塞到对应层级，不需要逐字段拆解
  rootNode.set("user/account/info", objectMapper.valueToTree(accountInstance));
  // 需要新增自定义层级时直接调用API生成节点，完全不用管JSON格式
  ObjectNode nodeConfig = rootNode.putObject("system/config");
  nodeConfig.put("version", "v2.0");
  // 最后一行直接输出最终JSON字符串
  String finalResponseJson = objectMapper.writeValueAsString(rootNode);
  

• 如果有大量固定结构的转换需求，直接用MapStruct定义映射接口，编译期自动生成字段赋值的转换代码，运行时反射开销几乎为0，比运行时动态映射的工具效率更高，完全不用写逐字段赋值的冗余代码，只需要定义接口的入参、出参结构，框架会自动完成映射逻辑。

避坑点 #

• 绝对不要用字符串拼接的方式生成多层嵌套JSON：嵌套层级越多，越容易出现语法错误、特殊字符转义问题，后期维护成本极高。
• Spring Boot项目不要自己手动创建ObjectMapper实例，直接注入容器中已经配置好的实例即可，能复用全局的日期格式、空值处理、枚举序列化规则，减少重复配置。
• 配合Lombok的@Data、@NoArgsConstructor等注解，可以省掉POJO的getter、setter、构造方法的冗余代码，进一步压缩开发量。

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