讲师中心 微信公众号
AI工具推荐 视频效率加速

JSON 无法正确反序列化为 Java POJO 对象的常见原因及解决方案

千芳姑娘_5787

千芳姑娘_5787

发布时间:2026-01-29 20:07:11

|

632人浏览过

|

来源于php中文网

原创

JSON 无法正确反序列化为 Java POJO 对象的常见原因及解决方案

使用 restassured 的 `extract().as(class)` 方法时,若 json 字段全部反序列化为 null,通常因默认 gson 配置不兼容嵌套数组结构、字段命名不一致或类型不匹配所致;本文详解根本原因并提供可靠修复方案。

在 RestAssured 测试中,response.extract().as(OriginalDTO.class) 表面简洁,但其底层依赖的是 RestAssured 内置的默认 Gson 实例(或 Jackson,取决于配置),该实例未启用对复杂嵌套结构的灵活解析能力——而这正是本例失败的核心原因。

观察提供的 JSON 响应结构可发现关键特征:

  • 所有顶层字段(如 "Content"、"Generic"、"Participants")均为 [ {...}, {...} ] 形式的 JSON 数组;
  • 但每个数组元素本身是单键对象,例如:{"Content": "An email includes Docx..."}、{"Participants": [...]}、{"Generic": [...]};
  • 更复杂的是,"Participants" 数组中还包含混合结构:既有含完整 participant 数据的对象,也有仅含 "Participants Count": "3" 的元数据对象。

而当前 OriginalDTO 的字段定义(如 private List<Content> content;)期望的是形如 [{"Subject":"..."},{"Content":"..."}] 的扁平数组,但实际 JSON 是 [{"Content":"..."},{"Content Html":"..."}] ——即每个数组项是一个以字段名为 key 的 Map-like 结构,而非直接对应 Content 类的实例。

因此,RestAssured 默认的反序列化器无法将 {"Content": "...”} 映射到 Content 对象(因缺少无参构造+匹配 setter),最终所有字段保持 null。

立即学习“Java免费学习笔记(深入)”;

✅ 正确解决方案:显式使用自定义 Gson 实例,并适配嵌套结构

html-to-pptx-converter
html-to-pptx-converter

使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。

下载

推荐采用如下方式替代 extract().as():

// 创建支持宽松解析的 Gson 实例
Gson gson = new GsonBuilder()
    .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES) // 可选:统一命名策略
    .enableComplexMapKeySerialization()
    .serializeNulls() // 确保 null 字段也被处理(便于调试)
    .create();

// 手动解析响应体
String jsonResponse = response.body().asString();
OriginalDTO original = gson.fromJson(jsonResponse, OriginalDTO.class);

⚠️ 同时,务必检查并修正 POJO 设计以匹配真实 JSON 结构:

  1. OriginalDTO 中 participants 字段类型错误
    当前定义:private List<Participant> participants;
    实际 JSON:"Participants": [ {"Participants": [...]}, {"Participants Count": "3"} ]
    → 应改为:

    @SerializedName("Participants")
    private List<ParticipantsWrapper> participants; // 新增包装类

    并定义:

    public class ParticipantsWrapper {
        @SerializedName("Participants")
        private List<Participant> participants;
    
        @SerializedName("Participants Count")
        private String participantsCount;
    
        // getter/setter
    }
  2. 类似地,content、generic、information 等字段均需对应包装类
    例如 ContentWrapper 包含 Subject、Content、Content Html、Record Date 等字段(注意空格和大小写),或使用 Map<String, Object> + 动态提取(适用于高度动态字段)。

  3. 避免过度依赖 @SerializedName 覆盖
    若字段名含空格(如 "Content Html")、大小写混杂(如 "Date Time Created"),建议在 Content 等子类中显式声明:

    public class Content {
        @SerializedName("Subject")
        private String subject;
    
        @SerializedName("Content")
        private String content;
    
        @SerializedName("Content Html")
        private String contentHtml;
    
        @SerializedName("Record Date")
        private String recordDate;
        // ...
    }

? 总结:

  • ❌ 不要依赖 extract().as(Class) 处理非标准 JSON(尤其是“数组内单键对象”模式);
  • ✅ 始终用 Gson.fromJson() + 显式配置控制反序列化行为;
  • ✅ POJO 结构必须严格镜像 JSON 的嵌套层级与键名,必要时引入 Wrapper 类;
  • ✅ 开启 GsonBuilder.serializeNulls() 和日志输出响应体,快速验证解析输入是否符合预期。

如此改造后,OriginalDTO 将能准确承载响应数据,字段不再为空。

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2135

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3262

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1096

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3739

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6379

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1678

2024.03.01

counta和count的区别
counta和count的区别

Count函数用于计算指定范围内数字的个数,而CountA函数用于计算指定范围内非空单元格的个数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3148

2023.11.20

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn