大家好，我是田螺。

我们日常开发中，经常涉及到DO、DTO、VO对象属性拷贝赋值，很容易想到org.springframework.beans.BeanUtils的copyProperties。它会自动通过反射机制获取源对象和目标对象的属性，并将对应的属性值进行复制。可以减少手动编写属性复制代码的工作量，提高代码的可读性和维护性。

(资料图)

但是你知道嘛？使用BeanUtils的copyProperties，会有好几个坑呢，今天田螺哥给大家盘点一下哈：

@Datapublic class SourceBean {    private Long age;}@Datapublic class TargetBean {    private String age;}public class Test {    public static void main(String[] args) {        SourceBean source = new SourceBean();        source.setAge(25L);        TargetBean target = new TargetBean();        BeanUtils.copyProperties(source, target);        System.out.println(target.getAge());  //拷贝赋值失败，输出null    }}

在上述demo中，源对象SourceBean的age属性是一个Long类型，而目标对象TargetBean的age属性是一个String类型。由于类型不匹配，BeanUtils.copyProperties不会赋值成功的。我跑demo的结果，控制台输出null。

先给大家复习一下，什么是深拷贝？什么是浅拷贝？

我再给个代码demo给大家看看哈：

public class Address {    private String city;    //getter 和 setter 方法省略}public class Person {    private String name;    private Address address;    //getter 和 setter 方法省略} Person sourcePerson = new Person(); sourcePerson.setName("John"); Address address = new Address(); address.setCity("New York"); sourcePerson.setAddress(address); Person targetPerson = new Person(); BeanUtils.copyProperties(sourcePerson, targetPerson); sourcePerson.getAddress().setCity("London"); System.out.println(targetPerson.getAddress().getCity());  // 输出为 "London"

在上述示例中，源对象Person的属性address是一个引用类型。当使用BeanUtils.copyProperties方法进行属性复制时，实际上只复制了引用，即目标对象targetPerson的address属性引用和源对象sourcePerson的address属性引用指向同一个对象。因此，当修改源对象的address对象时，目标对象的address对象也会被修改。

大家日常开发中，要注意这个坑哈~

public class SourceBean {    private String username;    // getter 和 setter 方法省略}public class TargetBean {    private String userName;    // getter 和 setter 方法省略} SourceBean source = new SourceBean(); source.setUsername("捡田螺的小男孩"); TargetBean target = new TargetBean(); BeanUtils.copyProperties(source, target); System.out.println(target.getUserName());   // 输出为 null

在上述示例中，源对象SourceBean的属性名称是username，而目标对象TargetBean的属性名称也是userName。但是，两个username，一个N是大写，一个n是小写，即属性名称不一致，BeanUtils.copyProperties方法无法自动映射这些属性（无法忽略大小写自动匹配），因此目标对象的userName属性值为null。

大家日常开发中，要注意这个坑哈~比如大小写不一致，差一两个字母等等。

@Datapublic class SourceBean {    private String name;    private String address;}@Datapublic class TargetBean {    private String name;    private String address;}SourceBean source = new SourceBean();source.setName("John");source.setAddress(null);TargetBean target = new TargetBean();target.setAddress("田螺address");BeanUtils.copyProperties(source, target);System.out.println(target.getAddress());  // 输出为 null

在上述示例中，源对象SourceBean的address属性值为null。默认情况下，BeanUtils.copyProperties方法会将源对象中的null值属性覆盖到目标对象中。因此，目标对象的address属性值也为null。

如果你不希望null值覆盖目标对象中的属性，可以使用BeanUtils.copyProperties方法的重载方法，并传入一个自定义的ConvertUtilsBean实例来进行配置。

BeanUtils.copyProperties其实有两个包，分别是spring、apache。大家注意一下哈，这两个包，是有点不一样的：

//org.springframework.beans.BeanUtils(源对象在左边，目标对象在右边)public static void copyProperties(Object source, Object target) throws BeansException //org.apache.commons.beanutils.BeanUtils（源对象在右边，目标对象在左边）public static void copyProperties(Object dest, Object orig) throws IllegalAccessException, InvocationTargetException

大家使用的时候，要注意一下哈，注意自己引入的哪个BeanUtils，写对应参数位置。

把SourceBean和TargetBean中的都有个属性isTianLuo,它们的数据类型保持不变,但是一个为基本类型boolean，一个为包装类型Boolean

@Datapublic class SourceBean {    private boolean isTianLuo;}@Datapublic class TargetBean {    private Boolean isTianLuo;}

跑测试用里的时候，发现赋值不上：

SourceBean source = new SourceBean();source.setTianLuo(true);TargetBean target = new TargetBean();BeanUtils.copyProperties(source, target);System.out.println(target.getIsTianLuo()); // 输出为 null

为什么呢？即使是一个包装类型，一个基本类型，应该可以赋值上才对的。

这是因为当属性类型为boolean时，属性名以is开头,属性名会去掉前面的is，因此源对象和目标对象属性对不上啦。

大家使用BeanUtils.copyProperties过程中，要注意哈~

在某些开发场景呢，如果我们要修改某个字段的赋值，我们可能会全文搜索它的所有set方法，看哪些地方引用到。

但是呢，如果使用BeanUtils.copyProperties，就不知道是否引用到对应的ste方法啦，即查找不到字段引用。这就可能导致你会漏掉修改对应的字段。

@Datapublic class CopySource {    public String outerName;    public CopySource.InnerClass innerClass;    @Data    public static class InnerClass {        public String InnerName;    }}@Datapublic class CopyTarget {    public String outerName;    public CopyTarget.InnerClass innerClass;    @Data   public static class InnerClass {        public String InnerName;    }}CopySource test1 = new CopySource();test1.outerName = "outTianluo";CopySource.InnerClass innerClass = new CopySource.InnerClass();innerClass.InnerName = "innerTianLuo";test1.innerClass = innerClass;System.out.println(test1);CopyTarget test2 = new CopyTarget();BeanUtils.copyProperties(test1, test2);System.out.println(test2);  //输出CopyTarget(outerName=outTianluo, innerClass=null)

以上demo中，CopySource和CopyTarget各自存在一个内部类InnerClass，虽然这个内部类属性也相同，类名也相同，但是在不同的类中，因此Spring会认为属性不同,不会Copy;

如果要复制成功，可以让他们指向同一个内部类。

BeanUtils.copyProperties要拷贝属性值成功，需要对应的bean要有getter和setter方法。因为它是用反射拿到set和get方法再去拿属性值和设置属性值的。

@Datapublic class SourceBean {    private String value;}@Getter   //没有对应的setter方法public class TargetBean {    private String value;}SourceBean source = new SourceBean();source.setValue("捡田螺的小男孩");TargetBean target = new TargetBean();BeanUtils.copyProperties(source, target);System.out.println(target.getValue()); //输出null

如果BeanUtils.copyProperties遇到泛型，也是很可能赋值失败的哈。大家看下这个例子：

@Datapublic class CopySource {    public String outerName;    public List clazz;    @Data    public static class InnerClass {        public String InnerName;    }}@ToString@Datapublic class CopyTarget {    public String outerName;    public List clazz;    @Data    public static class InnerClass {        public String InnerName;    }}CopySource test1 = new CopySource();test1.outerName = "outTianluo";CopySource.InnerClass innerClass = new CopySource.InnerClass();innerClass.InnerName = "innerTianLuo";List clazz = new ArrayList<>();clazz.add(innerClass);test1.setClazz(clazz);System.out.println(test1);CopyTarget test2 = new CopyTarget();BeanUtils.copyProperties(test1, test2);System.out.println(test2);  //输出CopyTarget(outerName=outTianluo, clazz=null)

这里面的例子，BeanUtils.copyProperties方法拷贝包含泛型属性的对象clazz。CopyTarget和CopySource的泛型属性类型不匹配，因此拷贝赋值失败。

由于这些BeanUtils类都是采用反射机制实现的，对程序的效率也会有影响。我跑了个demo对比：

SourceBean sourceBean = new SourceBean();sourceBean.setName("tianLuoBoy");TargetBean target = new TargetBean();long beginTime = System.currentTimeMillis();for (int i = 0; i < 100000; i++) {  //循环10万次      target.setName(sourceBean.getName());}System.out.println("common setter time:" + (System.currentTimeMillis() - beginTime));long beginTime1 = System.currentTimeMillis();for (int i = 0; i < 100000; i++) {  //循环10万次    BeanUtils.copyProperties(sourceBean, target);}System.out.println("bean copy time:" + (System.currentTimeMillis() - beginTime1));//输出common setter time:3bean copy time:331

可以发现，简单的setter和BeanUtils.copyProperties对比，性能差距非常大。因此，慎用BeanUtils.copyProperties！！！

以上聊了BeanUtils.copyProperties的11个坑，都是在跟大家聊，要慎用BeanUtils.copyProperties。那有没有推荐替换它的方案呢。

第一种，那就是使用原始的setter和getter方法。

使用手动的setter方法进行属性赋值。这种方法可能需要编写更多的代码，但是可以提供更细粒度的控制，并且在性能方面通常比BeanUtils.copyProperties更高效。

Target target = new Target();target.setName(source.getName());target.setAge(source.getAge());

如果实在对象bean的属性比较多的话，可以使用插件GenerateAllSetter，它可以一键生成对象的set方法，挺方便的。

第二种方案，使用映射工具库，如MapStruct、ModelMapper等，它们可以自动生成属性映射的代码。这些工具库可以减少手动编写setter方法的工作量，并提供更好的性能。

使用MapStruct的示例：

@Mapperpublic interface SourceTargetMapper {    SourceTargetMapper INSTANCE = Mappers.getMapper(SourceTargetMapper.class);    @Mapping(source = "name", target = "name")    @Mapping(source = "age", target = "age")    Target mapToTarget(Source source);}Target target = SourceTargetMapper.INSTANCE.mapToTarget(source);