巨坑系列：Java Bean 转 Map 的坑要注意

最新推荐文章于 2025-04-02 10:11:13 发布

无五1

最新推荐文章于 2025-04-02 10:11:13 发布

阅读量703

点赞数

文章标签： java json mybatis

本文链接：https://blog.youkuaiyun.com/m0_73493267/article/details/126746930

版权

本文探讨了在Java中将Bean转换为Map时遇到的常见问题，包括JSON反序列化导致的数据类型丢失（如Long转Integer，Date转Long等）以及属性名解析错误。通过示例代码和调试截图，详细分析了fastjson、commons-beanutils和cglib的BeanMap转换中的问题。最后，提出了一种基于dubbo的解决方案，虽然仍可能存在特定情况下的问题，但能更好地保持属性名的一致性。建议在使用相关框架时多做验证、阅读源码和调试。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

# 一、背景

有些业务场景下需要将 Java Bean 转成 Map 再使用。

本以为很简单场景，但是坑很多。

# 二、那些坑

2.0 测试对象

import lombok.Data;
import java.util.Date;


@Data
public class MockObject extends  MockParent{
    private Integer aInteger;
    private Long aLong;
    private Double aDouble;
    private Date aDate;
}

父类

import lombok.Data;


@Data
public class MockParent {
    private Long parent;
}

2.1 JSON 反序列化了类型丢失

2.1.1 问题复现

将 Java Bean 转 Map 最常见的手段就是使用 JSON 框架，如 fastjson 、 gson、jackson 等。但使用 JSON 将 Java Bean 转 Map 会导致部分数据类型丢失。如使用 fastjson ，当属性为 Long 类型但数字小于 Integer 最大值时，反序列成 Map 之后，将变为 Integer 类型。

maven 依赖：

<!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>2.0.8</version>
        </dependency>

示例代码：

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.TypeReference;
import java.util.Date;
import java.util.Map;


public class JsonDemo {
    public static void main(String[] args) {
        MockObject mockObject = new MockObject();
        mockObject.setAInteger(1);
        mockObject.setALong(2L);
        mockObject.setADate(new Date());
        mockObject.setADouble(3.4D);
        mockObject.setParent(3L);


       String json = JSON.toJSONString(mockObject);
       
        Map<String,Object> map =  JSON.parseObject(json, new TypeReference<Map<String,Object>>(){});


        System.out.println(map);
    }
}

结果打印：

{"parent":3,"ADouble":3.4,"ALong":2,"AInteger":1,"ADate":1657299916477}

调试截图：

通过 Java Visualizer 插件进行可视化查看：

2.2.2 问题描述

存在两个问题

（1）通过 fastjson 将 Java Bean 转为 Map ，类型会发生转变。如 Long 变成 Integer ，Date 变成 Long, Double 变成 Decimal 类型等。

（2）在某些场景下，Map 的 key 并非和属性名完全对应，像是通过 get set 方法“推断”出来的属性名。

2.2 BeanMap 转换属性名错误

2.2.1 commons-beanutils 的 BeanMap

maven 版本：

<!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
<dependency>
    <groupId>commons-beanutils</groupId>
    <artifactId>commons-beanutils</artifactId>
    <version>1.9.4</version>
</dependency>

代码示例：

import org.apache.commons.beanutils.BeanMap;
import third.fastjson.MockObject;
import java.util.Date;


public class BeanUtilsDemo {
    public static void main(String[] args) {
        MockObject mockObject = new MockObject();
        mockObject.setAInteger(1);
        mockObject.setALong(2L);
        mockObject.setADate(new Date());
        mockObject.setADouble(3.4D);
        mockObject.setParent(3L);


        BeanMap beanMap = new BeanMap(mockObject);
        System.out.println(beanMap);
    }
}

调试截图ÿ