如何让Spring Data JPA save方法排除@LastModifiedBy字段比对

问题分析 #

你遇到的核心问题是：Spring Data JPA的@LastModifiedBy审计字段会在实体生命周期的preUpdate阶段自动填充，即使业务字段没有任何变更，只要实体处于被管理状态，save方法就会触发数据库更新——因为审计字段被纳入了变更检测范围，加上@DynamicUpdate只会生成变更字段的SQL，但审计字段的变更会导致更新操作依然执行，既产生了不必要的数据库IO，还覆盖了原有的审计轨迹。

解决方案 #

方案一：自定义实体生命周期监听，仅在业务字段变更时更新审计字段 #

通过在实体中添加@PreUpdate和@PostLoad方法，手动保存业务字段的快照，在更新前检查业务字段是否变更，只有变更时才保留审计字段的更新，否则重置为快照值，避免触发数据库更新。

修改后的User实体示例：

@Entity
@Table(name="usr")
@DynamicUpdate
@EntityListeners(AuditingEntityListener.class)
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "usr_id")
    private Integer userId;
    
    @Column(name = "usr_frst_nm")
    private String firstName;
    
    @Column(name = "usr_lst_nm")
    private String lastName;
    
    @LastModifiedBy
    @Column(name = "lst_updtd_usr_id")
    private Integer lastUpdatedUserId;

    // 业务字段快照，用@Transient标记不映射到数据库
    @Transient
    private String firstNameSnapshot;
    @Transient
    private String lastNameSnapshot;
    @Transient
    private Integer lastUpdatedUserIdSnapshot;

    // 加载实体时保存快照
    @PostLoad
    public void postLoad() {
        this.firstNameSnapshot = this.firstName;
        this.lastNameSnapshot = this.lastName;
        this.lastUpdatedUserIdSnapshot = this.lastUpdatedUserId;
    }

    // 更新前检查业务字段是否变更
    @PreUpdate
    public void preUpdate() {
        if (!hasBusinessFieldsChanged()) {
            // 业务字段无变更，重置审计字段为快照值，避免触发更新
            this.lastUpdatedUserId = this.lastUpdatedUserIdSnapshot;
        }
        // 业务字段有变更时，保留AuditingEntityListener自动填充的审计值
    }

    // 业务字段变更判断逻辑
    private boolean hasBusinessFieldsChanged() {
        return !Objects.equals(this.firstName, this.firstNameSnapshot)
                || !Objects.equals(this.lastName, this.lastNameSnapshot);
                // 加上其他业务字段的比对逻辑
    }

    // getter和setter省略
}

方案二：自定义审计监听器，覆盖默认审计逻辑 #

继承Spring Data JPA的AuditingEntityListener，重写onPreUpdate方法，仅在业务字段变更时才执行审计字段的更新。

1. 自定义监听器：

public class CustomAuditingEntityListener extends AuditingEntityListener {

    @Override
    public void onPreUpdate(Object entity, AuditContext context) {
        // 仅当业务字段变更时，才执行默认审计逻辑
        if (isBusinessFieldsChanged(entity)) {
            super.onPreUpdate(entity, context);
        }
    }

    private boolean isBusinessFieldsChanged(Object entity) {
        if (!(entity instanceof User)) {
            return true;
        }
        User user = (User) entity;
        // 这里复用实体中的变更判断方法，或者直接在这里实现比对逻辑
        return user.hasBusinessFieldsChanged();
    }
}

2. 修改实体的监听器配置：

@Entity
@Table(name="usr")
@DynamicUpdate
@EntityListeners(CustomAuditingEntityListener.class) // 替换为自定义监听器
public class User {
    // 实体字段和快照逻辑同方案一
}

方案三：通用字段比对工具类（Service层优化） #

如果你不想修改实体和监听器，可以封装一个通用工具类，自动比对业务字段，仅在有变更时调用save方法，避免手动写每个字段的比对：

public class EntityUpdateChecker {
    public static <T> boolean hasChanges(T original, T updated, String... excludeFields) {
        Set<String> excludeSet = new HashSet<>(Arrays.asList(excludeFields));
        Field[] fields = original.getClass().getDeclaredFields();
        for (Field field : fields) {
            if (excludeSet.contains(field.getName()) || Modifier.isTransient(field.getModifiers())) {
                continue;
            }
            field.setAccessible(true);
            try {
                Object originalVal = field.get(original);
                Object updatedVal = field.get(updated);
                if (!Objects.equals(originalVal, updatedVal)) {
                    return true;
                }
            } catch (IllegalAccessException e) {
                throw new RuntimeException("字段比对失败", e);
            }
        }
        return false;
    }
}

在Service层使用：

@Override
@Transactional(rollbackFor = Exception.class)
public void updateUser(...) {
    User originalUser = userRepo.findById(userId)
            .orElseThrow(() -> new User_Not_Found_Exception("用户ID: " + userId + " 不存在"));

    // 复制原实体并设置新的业务字段
    User updatedUser = new User();
    BeanUtils.copyProperties(originalUser, updatedUser);
    updatedUser.setFirstName(firstName);
    updatedUser.setLastName(lastName);
    // 设置其他业务字段

    // 比对时排除ID和审计字段
    if (EntityUpdateChecker.hasChanges(originalUser, updatedUser, "userId", "lastUpdatedUserId")) {
        userRepo.save(updatedUser);
    }
}

方案选择 #

• 方案一和方案二更适合全局统一处理，从JPA生命周期层面解决问题，不需要在每个Service中重复写比对逻辑。
• 方案三适合快速改造现有代码，不需要修改实体结构，但需要在每个更新方法中调用工具类。

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