本文详解如何将含数组结构的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<String, 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<String, Object>比Map<String, String>更健壮——能正确容纳"id": 350（Integer）、"Datetime": "2022-10-20T13:50:49"（String）、"empty": false（Boolean）等不同JSON类型。
方案二：定义强类型实体类（推荐生产环境）
提升可读性、类型安全与IDE支持：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
@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;
// 其他分页字段同上（可按需添加）
}⚠️ 关键注意事项
-
HTML标签处理：原始JSON中"Email"字段值为"<a class=\"__cf_email__\" ...>[email protected]</a>"，这不是纯邮箱地址。实际使用前务必用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<Map<String, Object>> | 无需建模，灵活应对字段变动 |
| 生产环境/长期维护 | List<Person> + 强类型字段 | 类型安全、可读性强、易于单元测试、支持JSON Schema校验 |
只要保证Java字段类型与JSON数据结构严格一致（数组→List，对象→Map或POJO），即可彻底规避MismatchedInputException。切勿用Map承接JSON数组——这是90% JSON解析失败的根源。
