使用Hibernate实现仅更新非空属性的技术方案问询

你现在碰到的情况是：当用新建的DBTestAccount对象执行更新时，设置为null的countryCode会把数据库里原有的COUNTRY字段值覆盖成null，但你希望只更新那些非空的属性，忽略空值对原有字段的影响。下面给你几种可行的方案，从简单到灵活都有：

1. 官方方案：使用@DynamicUpdate注解 #

这是Hibernate原生提供的最直接的解决方案，只需要给你的实体类加上这个注解：

@Table(name = "TEST_TABLE")
@DynamicUpdate // 新增该注解
public class DBTestAccount {
    @Id
    @Column(name = "UUID", nullable = false, length = 36)
    private String uuid;
    @Column(name = "REGION")
    private String region;
    @Column(name = "COUNTRY")
    private String countryCode;
    
    // getters and setters
}

原理：@DynamicUpdate会让Hibernate生成UPDATE语句时，只包含实际被修改过的非空属性，不会把所有字段都塞进SQL里。这样数据库中原有的COUNTRY值就不会被null覆盖了。

注意：这个注解依赖Hibernate的状态追踪机制，如果你是用全新对象更新，建议先从Session中加载持久化对象，再修改属性：

// 先加载数据库中已存在的对象
DBTestAccount existingAccount = session.get(DBTestAccount.class, "testUUID");
// 只修改非空属性
existingAccount.setRegion("testRegion");
// countryCode未修改，不会出现在UPDATE语句中
session.update(existingAccount);

2. 手动控制：用BeanUtils拷贝非空属性 #

如果你的场景不适合依赖Hibernate状态追踪（比如从DTO转换实体），可以用Spring或Apache的BeanUtils工具，只拷贝非空属性：

// 1. 从数据库加载原有实体
DBTestAccount existingAccount = session.get(DBTestAccount.class, "testUUID");
// 2. 你的待更新对象
DBTestAccount updateAccount = new DBTestAccount();
updateAccount.setUuid("testUUID");
updateAccount.setRegion("testRegion");
updateAccount.setCountryCode(null);

// 3. 只拷贝非空属性到原有实体
BeanUtils.copyProperties(updateAccount, existingAccount, getNullPropertyNames(updateAccount));

// 4. 执行更新
session.update(existingAccount);

// 辅助方法：获取对象中所有null属性的名称
private String[] getNullPropertyNames(Object source) {
    final BeanWrapper src = new BeanWrapperImpl(source);
    PropertyDescriptor[] pds = src.getPropertyDescriptors();
    
    Set<String> emptyNames = new HashSet<>();
    for (PropertyDescriptor pd : pds) {
        Object srcValue = src.getPropertyValue(pd.getName());
        if (srcValue == null) {
            emptyNames.add(pd.getName());
        }
    }
    return emptyNames.toArray(new String[0]);
}

这种方式完全手动控制更新字段，不需要依赖Hibernate的特性，适合复杂的DTO转实体场景。

3. 通用方案：自定义注解+AOP #

如果想要全局统一处理非空更新，避免重复代码，可以自定义注解结合AOP实现：

步骤1：自定义注解 #

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface UpdateNonNullProperties {
}

步骤2：编写AOP切面 #

@Aspect
@Component
public class UpdateNonNullAspect {

    @Autowired
    private SessionFactory sessionFactory;

    @Around("@annotation(UpdateNonNullProperties)")
    public Object handleNonNullUpdate(ProceedingJoinPoint joinPoint) throws Throwable {
        Object[] args = joinPoint.getArgs();
        // 假设所有实体都继承BaseEntity，包含getId()方法
        if (args.length == 0 || !(args[0] instanceof BaseEntity)) {
            return joinPoint.proceed();
        }

        BaseEntity updateEntity = (BaseEntity) args[0];
        // 加载数据库中原有实体
        BaseEntity existingEntity = sessionFactory.getCurrentSession()
                .get(updateEntity.getClass(), updateEntity.getId());
        // 拷贝非空属性
        BeanUtils.copyProperties(updateEntity, existingEntity, getNullPropertyNames(updateEntity));
        // 用更新后的原有实体执行方法
        return joinPoint.proceed(new Object[]{existingEntity});
    }

    // 复用之前的null属性获取方法
    private String[] getNullPropertyNames(Object source) {
        final BeanWrapper src = new BeanWrapperImpl(source);
        PropertyDescriptor[] pds = src.getPropertyDescriptors();
        
        Set<String> emptyNames = new HashSet<>();
        for (PropertyDescriptor pd : pds) {
            Object srcValue = src.getPropertyValue(pd.getName());
            if (srcValue == null) {
                emptyNames.add(pd.getName());
            }
        }
        return emptyNames.toArray(new String[0]);
    }
}

步骤3：使用自定义注解 #

在你的更新方法上标注注解即可自动处理：

@UpdateNonNullProperties
public void updateDBTestAccount(DBTestAccount account) {
    session.update(account);
}

方案对比 #

• @DynamicUpdate：最简单，官方原生支持，适合大多数常规更新场景；
• BeanUtils拷贝：灵活可控，适合DTO与实体转换的复杂场景；
• 自定义注解+AOP：全局通用，减少重复代码，适合大型项目的统一更新规则。

内容的提问来源于stack exchange，提问作者Rajat Mishra