激活Data JPA字节码增强后Spring JPA审计更新字段失效求助

项目配置与问题现象 #

1. 字节码增强配置 #

已在Spring Data JPA项目中通过pom.xml启用Hibernate字节码增强，配置如下：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <configuration>
    <source>11</source>
    <target>11</target>
  </configuration>
</plugin>
<plugin>
  <groupId>org.hibernate.orm.tooling</groupId>
  <artifactId>hibernate-enhance-maven-plugin</artifactId>
  <version>5.6.14.Final</version>
  <executions>
    <execution>
      <configuration>
        <failOnError>true</failOnError>
        <enableLazyInitialization>true</enableLazyInitialization>
        <enableDirtyTracking>true</enableDirtyTracking>
      </configuration>
      <goals>
        <goal>enhance</goal>
      </goals>
    </execution>
  </executions>
</plugin>

2. Spring JPA审计配置 #

• 定义带@EntityListeners(AuditingEntityListener.class)的抽象类Auditable，包含@CreatedBy、@CreatedDate、@LastModifiedBy、@LastModifiedDate字段
• 创建继承Auditable的Dashboard实体类
• 实现AuditorAwareImpl类并配置为Spring Bean

3. 问题 #

创建Dashboard实体时，数据库中created_by和created_date字段正常更新；但修改实体时，modified_by和modified_date字段无任何更新。关闭Bytecode Enhancement后，所有审计字段均正常工作。

临时解决方案 #

在Auditable类中添加@PreUpdate方法触发审计：

@PreUpdate
void preUpdate(){
  var tempModifiedBy = this.modifiedBy;
  this.setModifiedBy(null);
  this.setModifiedBy(tempModifiedBy);
}

优雅解决方案及问题分析 #

问题根源 #

这是Hibernate字节码增强的**脏跟踪（Dirty Tracking）**特性与Spring Data JPA审计机制的设计冲突：

• 启用enableDirtyTracking后，Hibernate通过字节码生成的拦截器跟踪实体变化，仅当业务字段（非审计字段）发生变更时，才会标记实体为"脏数据"
• Spring JPA的AuditingEntityListener仅在实体被标记为脏数据后，才会触发@LastModifiedBy和@LastModifiedDate的更新逻辑
• 如果仅触发更新操作但未修改业务字段，Hibernate不会识别实体变更，审计更新自然不会执行

两种优雅解决方式 #

方式1：禁用Hibernate脏跟踪（无需该特性时）

修改hibernate-enhance-maven-plugin配置，移除enableDirtyTracking，让Hibernate回到传统的脏检查机制，Spring JPA审计即可正常触发：

<plugin>
  <groupId>org.hibernate.orm.tooling</groupId>
  <artifactId>hibernate-enhance-maven-plugin</artifactId>
  <version>5.6.14.Final</version>
  <executions>
    <execution>
      <configuration>
        <failOnError>true</failOnError>
        <enableLazyInitialization>true</enableLazyInitialization>
        <!-- 移除脏跟踪配置 -->
      </configuration>
      <goals>
        <goal>enhance</goal>
      </goals>
    </execution>
  </executions>
</plugin>

方式2：保留脏跟踪，手动触发审计更新

如果需要保留脏跟踪特性，可在Auditable类的@PreUpdate阶段手动设置审计字段，绕过Hibernate的脏检查限制：

@EntityListeners(AuditingEntityListener.class)
public abstract class Auditable {
    // 原有审计字段定义
    
    @Autowired
    private AuditorAware<String> auditorAware;
    private Clock clock = Clock.systemDefaultZone();

    @PreUpdate
    public void onPreUpdate() {
        this.setLastModifiedBy(auditorAware.getCurrentAuditor().orElse(null));
        this.setLastModifiedDate(LocalDateTime.now(clock));
    }
}

是否为Bug？ #

这不属于严格意义上的Bug，而是两种机制的设计目标冲突：Hibernate脏跟踪为了性能优化，减少不必要的数据库更新；Spring JPA审计期望只要触发更新操作就同步审计字段。两者设计逻辑不一致导致了该问题。

内容的提问来源于stack exchange，提问作者Jean-François Legendre