如何高效将对象列表转换为结构化 JSON（基于 Jackson 的最佳实践）

使用 Jackson 库将 Ja va 对象列表优雅、健壮地转换为符合嵌套结构要求的 JSON 数据，告别手拼 Map 和 ObjectNode 的苦活，让代码在可读性、可维护性与类型安全性上同时上台阶。

日常开发中，把一组领域对象（比如 ObjectVO）按特定规则聚合、分组，再序列化成特定结构的 JSON，这种需求有多常见？非常常见。但常见的实现方式却往往不太优雅——用 MultiValueMap<类型, Map<…>> 手动构建中间映射，再一层层地堆 ObjectNode 和 ArrayNode。结果呢？代码又长又容易出错：字段名写错、类型强转失手、空指针偷偷潜入……更重要的是，这种做法完全违背了面向对象的设计原则——编译器的类型检查形同虚设，代码的语义表达能力也几乎归零。 更好的解法其实很清晰：定义好 DTO 结构 + 利用 Jackson 自身的序列化能力 + 合理的分组逻辑。下面直接上推荐做法。

第一步：定义目标 JSON 对应的 Ja va 类型

推荐用 Record（或 Lombok）搞定。 ```ja va // 表示 input 数组中的每个子项 public record InputItem( @JsonProperty("id") Long idOrigin, @JsonProperty("state") String state, @JsonProperty("local") String local, @JsonProperty("number") Long number ) {} // 表示顶层 JSON 对象（对应每个唯一 id + observation 组合） public record GroupedItem( @JsonProperty("id") Long id, @JsonProperty("observation") String observation, @JsonProperty("input") List input ) {} ``` > **提示**：用 @JsonProperty 显式声明字段映射，能避免因命名差异（比如 code 要变成 "observation"）导致的序列化失败。Ja va 14+ 推荐用 record，不可变性和简洁性兼顾。

第二步：按业务键对原始 ObjectVO 列表分组

```ja va List voList = ...; // 原始输入 Map> grouped = voList.stream() .collect(Collectors.groupingBy( vo -> vo.getId() + "_" + vo.getCode(), // 复合键保证唯一性 LinkedHashMap::new, Collectors.toList() )); ```

第三步：转换为 GroupedItem 列表，交给 Jackson 序列化

```ja va ObjectMapper mapper = new ObjectMapper(); mapper.enable(SerializationFeature.INDENT_OUTPUT); // 格式化输出，看需要 List result = grouped.entrySet().stream() .map(entry -> { String[] parts = entry.getKey().split("_"); Long id = Long.parseLong(parts[0]); String observation = parts[1]; List inputItems = entry.getValue().stream() .map(vo -> new InputItem( vo.getOriginId(), // 注意字段映射：Origin ID → idOrigin vo.getState(), vo.getLocal(), vo.getNumber() )) .toList(); return new GroupedItem(id, observation, inputItems); }) .toList(); // 一行搞定 JSON 序列化 String jsonOutput = mapper.writeValueAsString(result); System.out.println(jsonOutput); ```

必须注意的关键点

- **字段映射一致性**：原始数据中 code 字段要作为 "observation" 输出，Origin id 要变成 "id"（InputItem 里的那个）。一定要通过 @JsonProperty 或者构造器参数名严格对齐，一不小心就出 bug。 - **空值与异常处理**：生产环境建议把 writeValueAsString() 调用包起来，捕获 JsonProcessingException，不要裸奔。 - **性能考量**：数据量极大时（超过 10 万条），可以考虑用流式 JsonGenerator 替代在内存中构建整个 List。但说实话，绝大多数场景根本用不着提前优化。 - **避开一个常见反模式**：不推荐直接操作 ObjectNode/ArrayNode 去构建复杂结构。这条路绕过了类型系统，调试起来头疼，单元测试也不好写。

总结一下

和之前那种基于 MultiValueMap + 手动摆弄 ObjectNode 的做法相比，这套方案的优势很明显： - 类型安全：编译器在编译期就能帮你检查字段是否存在、类型是否匹配。 - 可读性强：结构就是契约，DTO 直接表达了 JSON Schema。 - 易于测试：分组逻辑、DTO 构造逻辑、序列化结果可以分开验证。 - 可扩展性好：新增字段只需要更新 DTO 和对应的映射逻辑，不需要重写整个 JSON 构建流程。 Jackson 真正的价值，从来不只是“能解析任意 JSON”。**让 Ja va 类型成为 JSON 结构的一等公民**——这才是它值得被认真对待的原因。学会拥抱它，而不是跳过它。