JSON嵌套数组处理与DTO映射技巧

本文深入解析了Java中处理含`content`数组字段的分页JSON响应时常见的`MismatchedInputException`异常根源——即DTO中误将JSON数组声明为Map类型，导致Jackson反序列化失败；并系统性地提供了两种高效可靠的解决方案：一是使用泛型`List

本文详解如何将含content数组字段的分页JSON响应准确反序列化为Java DTO，解决因类型不匹配导致的MismatchedInputException异常，并提供泛型Map与专用实体类两种推荐方案。

本文详解如何将含`content`数组字段的分页JSON响应准确反序列化为Java DTO，解决因类型不匹配导致的`MismatchedInputException`异常，并提供泛型Map与专用实体类两种推荐方案。

在Spring Boot等基于Jackson的Java应用中，将JSON响应映射到DTO（Data Transfer Object）是常见需求。但当JSON中的字段实际为数组（如 "content": [...]），而DTO中却声明为Map类型时，Jackson会抛出典型的类型不匹配异常：

com.fasterxml.jackson.databind.exc.MismatchedInputException: 
Cannot deserialize value of type java.util.LinkedHashMap from Array value

根本原因在于：JSON中"content"是一个JSON数组（JsonToken.START_ARRAY），而你的OtherResponse DTO将其声明为private Map content——Jackson无法将数组自动转为Map，必须显式声明为List类型。

✅ 正确做法：按JSON结构精准声明DTO字段类型

方案一：使用泛型List>（快速适配，适合动态结构）

import com.fasterxml.jackson.annotation.JsonProperty;
import org.springframework.data.domain.Pageable;

@Data
public class OtherResponse {
    @JsonProperty("content")
    private List<Map<String, Object>> content; // ✅ 数组 → List，元素为键值对

    @JsonProperty("pageable")
    private Pageable pageable;

    // 其他分页元字段（如totalElements、last等）可按需添加，或直接复用Pageable接口
}

? 提示：Map能兼容JSON中任意类型的值（如String、Number、Boolean甚至嵌套Object），比Map更健壮（原答案中String类型会丢失数字/布尔等原始类型）。

方案二：定义强类型实体类（推荐用于生产环境）

为content数组中的每个对象创建专用DTO，提升可读性、类型安全与IDE支持：

@Data
public class Person {
    private Long id;
    private String reg;
    @JsonProperty("Email")
    private String email; // 注意：JSON中键为"Email"（大写E），需显式映射
    @JsonProperty("Mobile")
    private String mobile;
    private String name;
    @JsonProperty("Ip")
    private String ip;
    @JsonProperty("Datetime")
    private LocalDateTime datetime; // 需配合@JsonFormat注解或自定义Deserializer
}

@Data
public class OtherResponse {
    @JsonProperty("content")
    private List<Person> content;

    @JsonProperty("pageable")
    private Pageable pageable;

    // 可选：直接继承Spring Data的PageImpl，或手动映射totalElements、last等字段
}

若需解析"Datetime"为LocalDateTime，请添加格式支持：

@JsonProperty("Datetime")
@JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss")
private LocalDateTime datetime;

⚠️ 关键注意事项

• 勿省略@JsonProperty：当JSON字段名与Java属性名不一致（如"Email" vs email）时，必须通过@JsonProperty显式绑定，否则反序列化为null。
• 分页元数据复用：Pageable是Spring Data的标准接口，Jackson默认可解析其结构；如需访问totalElements、last等字段，建议直接在OtherResponse中声明对应属性（类型为long/boolean），或使用PageImpl封装。
• 避免裸Map/List：虽然List>灵活，但丧失编译期检查和文档表达力，仅建议用于原型开发或高度动态场景。

✅ 总结

解决JSON数组→DTO映射异常的核心原则是：DTO字段类型必须与JSON结构严格一致。将"content": [...]映射为List而非Map，并根据业务确定使用泛型Map还是强类型实体类。搭配@JsonProperty和@JsonFormat等Jackson注解，即可实现健壮、可维护的JSON反序列化。

终于介绍完啦！小伙伴们，这篇关于《JSON嵌套数组处理与DTO映射技巧》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！