JSON解析与DTO映射：正确处理嵌套数组型content字段-java教程-PHP中文网

JSON解析与DTO映射：正确处理嵌套数组型content字段

本文详解如何将含数组结构的JSON（如Spring Data分页响应）准确反序列化为Java DTO，重点解决因类型不匹配导致的MismatchedInputException异常，并提供泛型Map与专用实体类两种优雅方案。

本文详解如何将含数组结构的json（如spring data分页响应）准确反序列化为java dto，重点解决因类型不匹配导致的`mismatchedinputexception`异常，并提供泛型map与专用实体类两种优雅方案。

在处理Spring Boot后端返回的标准分页JSON响应时，常见错误是将"content"字段（实际为JSON数组）误定义为Map或单个对象，从而触发Jackson反序列化异常：

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

根本原因在于：JSON中"content"对应的是[ {...}, {...} ]——即JSON数组，而你的DTO中却声明为private Map content;，Jackson无法将数组（START_ARRAY）转为Map（期望START_OBJECT）。

✅ 正确做法：匹配JSON结构定义DTO

方案一：使用泛型List + Map（快速适配，无需新建类）

适用于临时解析、键名动态或结构简单场景：

import com.fasterxml.jackson.annotation.JsonProperty;
import org.springframework.data.domain.Pageable;
import lombok.Data;
import java.util.List;
import java.util.Map;

@Data
public class OtherResponse {
    @JsonProperty("content")
    private List<map object>> content; // ✅ 支持任意值类型（String/Number/Boolean/Null）

    @JsonProperty("pageable")
    private Pageable pageable;

    // 其他分页元字段（可选，若需手动读取）
    private boolean last;
    private int totalPages;
    private long totalElements;
    private boolean first;
    private int numberOfElements;
    private int size;
    private int number;
    private boolean empty;
}</map>

? Map比Map更健壮——能正确容纳"id": 350（Integer）、"Datetime": "2022-10-20T13:50:49"（String）、"empty": false（Boolean）等不同JSON类型。

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

提升可读性、类型安全与IDE支持：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

@Data
public class Person {
    private Long id;
    private String reg;
    private String email; // 注意：原始JSON中Email是含HTML标签的字符串，需额外清洗
    private String mobile;
    private String name;
    private String ip;
    private String datetime; // 或使用 @JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss") LocalDateTime
}

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

    @JsonProperty("pageable")
    private Pageable pageable;

    // 其他分页字段同上（可按需添加）
}</person>

⚠️ 关键注意事项

HTML标签处理：原始JSON中"Email"字段值为"[email protected]"，这不是纯邮箱地址。实际使用前务必用Jsoup或正则提取真实邮箱，例如：
```
String rawEmailHtml = person.getEmail();
String cleanEmail = Jsoup.parse(rawEmailHtml).text(); // → "test@example.com"
```
日期格式："Datetime": "2022-10-20T13:50:49"符合ISO 8601，建议在Person中声明为LocalDateTime并配合@JsonFormat：
```
@JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss")
private LocalDateTime datetime;
```

依赖导入：确保项目已引入Lombok（@Data）和Spring Data（Pageable）：

<!-- Maven -->
<dependency><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-data-jpa</artifactid></dependency><dependency><groupid>org.projectlombok</groupid><artifactid>lombok</artifactid><optional>true</optional></dependency>

✅ 总结

场景	推荐方式	优势
快速验证/原型开发	List>	无需建模，灵活应对字段变动
生产环境/长期维护	List + 强类型字段	类型安全、可读性强、易于单元测试、支持JSON Schema校验