BeanUtils.copyProperties如何忽略属性类型差异？

Question

在使用 `BeanUtils.copyProperties` 进行 Java Bean 属性拷贝时，经常会遇到源对象与目标对象之间存在同名但类型不同的属性。此时，`BeanUtils.copyProperties` 默认会尝试进行类型转换，但若转换失败，则会抛出异常或导致拷贝失败。那么，如何在属性类型不一致时实现自动忽略或自定义处理？这是开发中常见的问题，尤其是在 DTO 与 Entity 之间进行转换时尤为典型。本文将探讨如何通过自定义封装或使用其他工具类（如 Spring 的 `BeanUtils` 或 Dozer、MapStruct 等）来实现忽略类型差异的属性拷贝。

Answer 1

Java Bean 属性拷贝中的类型不一致问题及解决方案

1. 问题背景与常见场景

在 Java 开发中，尤其是 Spring Boot、微服务架构等项目中，经常需要在 DTO（Data Transfer Object）、Entity、VO（View Object）之间进行属性拷贝。常用的工具包括 Apache Commons BeanUtils、Spring BeanUtils、Dozer、MapStruct 等。

一个常见问题是：源对象与目标对象中存在同名属性但类型不同。例如：

• 源属性为 String，目标属性为 Integer
• 源属性为 Date，目标属性为 String
• 源属性为 BigDecimal，目标属性为 Double

此时，BeanUtils.copyProperties 方法会尝试自动转换类型，若转换失败则抛出异常，导致拷贝失败。

2. 常见处理方式分析

以下是几种常见的处理方式及其优缺点：

方式	优点	缺点
使用 try-catch 包裹	实现简单，无需引入新依赖	代码冗余，无法精细控制字段处理
自定义封装 BeanUtils 工具类	可扩展性强，可自定义字段处理逻辑	开发成本高，需维护转换逻辑
使用 MapStruct	编译期生成代码，性能高，支持类型转换和自定义映射	需学习注解和配置，对复杂类型支持有限
使用 Dozer	支持深度拷贝，可配置映射规则	性能较低，已停止维护
使用 ModelMapper	自动类型推断，配置灵活	性能一般，类型转换可能出错

3. 自定义封装 BeanUtils 工具类示例

为了在属性类型不一致时忽略或自定义处理，我们可以封装一个通用的 Bean 工具类：

public class CustomBeanUtils {
    public static void copyPropertiesIgnoreType(Object dest, Object orig) {
        try {
            Map origMap = new HashMap<>();
            BeanUtils.getPropertyUtils().getPropertyDescriptors(orig)
                    .forEach(pd -> {
                        if (pd.getReadMethod() != null) {
                            try {
                                origMap.put(pd.getName(), PropertyUtils.getSimpleProperty(orig, pd.getName()));
                            } catch (Exception e) {
                                // 忽略异常
                            }
                        }
                    });

            BeanUtils.getPropertyUtils().getPropertyDescriptors(dest)
                    .forEach(pd -> {
                        if (pd.getWriteMethod() != null && origMap.containsKey(pd.getName())) {
                            try {
                                Object value = origMap.get(pd.getName());
                                if (value != null && pd.getPropertyType().isAssignableFrom(value.getClass())) {
                                    PropertyUtils.setSimpleProperty(dest, pd.getName(), value);
                                }
                            } catch (Exception e) {
                                // 忽略类型不匹配或异常
                            }
                        }
                    });
        } catch (Exception e) {
            // 忽略整体异常
        }
    }
}

该类通过反射获取属性并进行类型匹配，若类型不一致则跳过，避免抛出异常。

4. 使用 MapStruct 实现类型转换与忽略

MapStruct 是一种编译期生成映射代码的方案，支持类型转换和自定义映射逻辑。以下是一个示例：

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    @Mapping(target = "age", source = "ageStr", qualifiedByName = "stringToInteger")
    User toUser(UserDTO userDTO);

    @Named("stringToInteger")
    default Integer stringToInteger(String ageStr) {
        try {
            return Integer.parseInt(ageStr);
        } catch (NumberFormatException e) {
            return null; // 忽略无法转换的字段
        }
    }
}

通过自定义转换方法，可以灵活控制字段的映射逻辑。

5. 技术选型建议与流程图

根据项目需求和技术栈，选择合适的属性拷贝方案至关重要。以下是一个决策流程图：

graph TD A[开始] --> B{是否需要高性能} B -->|是| C[使用 MapStruct] B -->|否| D[使用 Spring BeanUtils 或 Apache Commons] D --> E{是否需要自定义转换} E -->|是| F[封装工具类或使用 ModelMapper] E -->|否| G[直接使用默认拷贝] C --> H{是否需要复杂映射} H -->|是| I[使用 MapStruct + 自定义 Converter] H -->|否| J[使用 MapStruct 简单映射]