Java解决Jackson反序列化字段名不匹配问题

 更新时间:2026年02月06日 09:40:17   作者:go 码头整点薯条  
这篇文章主要介绍了Java中使用Jackson库处理JSON数据时常见的字段名不匹配问题,并提供了多种解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

在 Java 开发XML中,我们经常使用 Jackson 库来处理 JSON 数据的序列化和反序列化。然而,在实际开发中,由于 JSON 和 Java 对象的字段命名风格不一致(如大小写、is 前缀等),经常会出现 UnrecognizedPropertyException 错误。本文将结合一个实际案例,分析常见的字段名不匹配问题,并提供多种解决方案,帮助开发者高效应对类似问题。

问题背景

假设我们有一个 JSON 数据,结构如下:

{
    "id": null,
    "msg": null,
    "isSuccess": true,
    "code": null,
    "data": {
        "Total": 1700,
        "Rows": [...]
    }
}

对应的 Java 类 ExamListResponseVo 定义如下:

@Data
public class ExamListResponseVo {
    private Object id;
    private String msg;
    private boolean isSuccess; // 问题1:Jackson 默认会去掉 is 前缀
    private Object code;
    private ExamListData data;

    @Data
    public static class ExamListData {
        private Integer total; // 问题2:JSON 中是 "Total",大小写不匹配
        private List<ExamRow> rows;
    }
}

当我们使用 ObjectMapper 反序列化时,可能会遇到以下两个错误:

error:Unrecognized field "isSuccess"

原因:isSuccess 在 JSON 中是 isSuccess,但 Jackson 默认会去掉 is 前缀,尝试匹配 success。

error:Unrecognized field "Total"

原因:JSON 中的 "Total" 是首字母大写,而 Java 类中是 total,大小写不匹配。

解决方案

1. 解决isSuccess问题

方案 1:修改 Java 字段名(推荐)

private boolean success; // 改为 success,与 Jackson 默认行为一致

方案 2:使用@JsonProperty注解

@JsonProperty("isSuccess") // 强制匹配 JSON 中的 isSuccess
private boolean isSuccess;

方案 3:配置ObjectMapper禁用is前缀处理

ObjectMapper mapper = new ObjectMapper();
mapper.configure(MapperFeature.USE_STD_BEAN_NAMING, true); // 禁止自动去掉 is 前缀

2. 解决Total大小写问题

方案 1:修改 Java 字段名(推荐)

private Integer Total; // 与 JSON 完全一致

方案 2:使用@JsonProperty注解

@JsonProperty("Total")
private Integer total;

方案 3:配置ObjectMapper忽略大小写

ObjectMapper mapper = new ObjectMapper();
mapper.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);

方案 4:忽略未知字段(适用于不可控 JSON 结构)

@Data
@JsonIgnoreProperties(ignoreUnknown = true) // 忽略 JSON 中多余的字段
public static class ExamListData {
    private Integer total;
    private List<ExamRow> rows;
}

最佳实践

1. 保持 JSON 和 Java 字段名一致

  • 如果 JSON 可控,建议统一命名风格,如全部使用 snake_case 或 camelCase

2. 优先使用@JsonProperty注解

  • 适用于需要保留原有 Java 字段名但 JSON 字段名不同的情况。

3. 全局配置ObjectMapper

  • 如果项目中有大量大小写不一致的情况,可以全局配置:

    ObjectMapper mapper = new ObjectMapper();
    mapper.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);
    mapper.configure(MapperFeature.USE_STD_BEAN_NAMING, true);

4. 使用@JsonIgnoreProperties避免未知字段报错

  • 适用于第三方 API 返回的 JSON 结构可能变化的情况。

完整代码示例

修正后的ExamListResponseVo

@Data
@JsonIgnoreProperties(ignoreUnknown = true) // 可选:忽略未知字段
public class ExamListResponseVo {
    private Object id;
    private String msg;
    @JsonProperty("isSuccess") // 显式指定 JSON 字段名
    private boolean isSuccess;
    private Object code;
    private ExamListData data;

    @Data
    public static class ExamListData {
        @JsonProperty("Total") // 显式指定 JSON 字段名
        private Integer total;
        private List<ExamRow> rows;
    }
}

反序列化代码

ObjectMapper mapper = new ObjectMapper();
// 可选:全局配置
// mapper.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);

String responseBody = "..."; // JSON 字符串
ExamListResponseVo result = mapper.readValue(responseBody, ExamListResponseVo.class);

总结

问题解决方案适用场景
isSuccess 不匹配修改字段名 / @JsonProperty布尔字段带 is 前缀
Total 大小写问题修改字段名 / @JsonProperty / 全局配置JSON 字段名大小写不一致
未知字段报错@JsonIgnoreProperties第三方 API 返回不可控 JSON

推荐做法:

  • 尽量统一 JSON 和 Java 字段名(如 camelCase)。
  • 必要时使用 @JsonProperty 显式映射。
  • 全局配置 ObjectMapper 适用于大型项目。
  • 使用 @JsonIgnoreProperties 增强鲁棒性。

通过本文的解决方案,你可以轻松应对 Jackson 反序列化时的字段名不匹配问题,提高开发效率!

到此这篇关于Java解决Jackson反序列化字段名不匹配问题的文章就介绍到这了,更多相关Java Jackson反序列化字段名不匹配内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java随机生成字符串的四种方式例子

    Java随机生成字符串的四种方式例子

    这篇文章主要给大家介绍了关于Java随机生成字符串的四种方式,随机数在实际中使用很广泛,比如要随即生成一个固定长度的字符串、数字,文中给出了详细的代码示例,需要的朋友可以参考下
    2023-10-10
  • 剖析SpringCloud Feign中所隐藏的坑

    剖析SpringCloud Feign中所隐藏的坑

    这篇文章主要为大家介绍了剖析SpringCloud Feign中所隐藏的坑示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • 深入理解Java中的volatile关键字(总结篇)

    深入理解Java中的volatile关键字(总结篇)

    volatile这个关键字,不仅仅在Java语言中有,在很多语言中都有的,而且其用法和语义也都是不尽相同的。这篇文章主要介绍了Java中的volatile关键字,需要的朋友可以参考下
    2018-10-10
  • Spring Boot Rest控制器单元测试过程解析

    Spring Boot Rest控制器单元测试过程解析

    这篇文章主要介绍了Spring Boot Rest控制器单元测试过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-03-03
  • 解决@RequestBody使用不能class类型匹配的问题

    解决@RequestBody使用不能class类型匹配的问题

    这篇文章主要介绍了解决@RequestBody使用不能class类型匹配的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • springboot整合EHCache的实践方案

    springboot整合EHCache的实践方案

    EhCache是一个纯Java的进程内缓存框架,具有快速、精干等特点,是Hibernate中默认的CacheProvider。这篇文章给大家介绍了springboot整合EHCache的实践方案,需要的朋友参考下
    2018-01-01
  • java实现酷狗音乐临时缓存文件转换为MP3文件的方法

    java实现酷狗音乐临时缓存文件转换为MP3文件的方法

    这篇文章主要介绍了java实现酷狗音乐临时缓存文件转换为MP3文件的方法,涉及java针对文件操作的相关技巧,需要的朋友可以参考下
    2016-08-08
  • java实现MD5加密方法汇总

    java实现MD5加密方法汇总

    本文给大家汇总介绍了2种java实现MD5加密的方法,非常的实用,这里分享给大家,学习下其中的思路,对大家学习java非常有帮助。
    2015-10-10
  • 关于log4j漏洞修复解决方案及源码编译

    关于log4j漏洞修复解决方案及源码编译

    Log4j 是Apache为Java提供的日志管理工具。他与System.out.println()的作用相似,用来跟踪、调试、维护程序。这篇文章主要介绍了关于log4j漏洞修复解决方案及源码编译,需要的朋友可以参考下
    2021-12-12
  • mybatis-plus排除非表中字段的操作

    mybatis-plus排除非表中字段的操作

    这篇文章主要介绍了mybatis-plus排除非表中字段的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12

最新评论