Spring JPA如何仅在实体字段修改时执行保存操作？

问题背景 #

在Spring JPA中，未找到原生机制实现仅当实体字段存在修改时才执行保存。当前核心需求是：从JPA获取记录后，在保存前验证字段是否有变更，避免无变更时updated_at字段被更新（MySQL表中updated_at配置了ON UPDATE CURRENT_TIMESTAMP，同时实体类用@LastModifiedDate维护该字段）。

现有实现是通过克隆原对象，对比修改前后的差异来决定是否保存：

Class obj = repository.findById(id);
Class cloneObj = cloneObject(obj);
process(obj);
if (hasModifications(obj,cloneObj))
   repository.save(obj);
else
   //don't save

尝试过的无效方案：

• 在实体类添加@DynamicUpdate注解，未生效
• 使用@Transactional注解并移除手动save调用，updated_at仍会被更新

补充信息 #

1. MySQL表定义（核心字段）：

CREATE TABLE `username` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT,
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `info` mediumtext,
  `status` varchar(255) NOT NULL,
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `version` int NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_updated_at` (`updated_at`),
  KEY `idx_created_at` (`created_at`)
)

2. 实体类代码（GratificationEntityTask）：

@Entity
@Table(name = "gratification_entity_task")
@JsonIgnoreProperties(
        value = {"createdAt", "updatedAt"},
        allowGetters = true)
@EntityListeners(AuditingEntityListener.class)
public class GratificationEntityTask {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Enumerated(EnumType.STRING)
    private TaskStatus status;
    @Convert(converter = InfoConverter.class)
    private Info info;
    @CreatedDate
    private Date createdAt;
    @LastModifiedDate
    private Date updatedAt;
    @Version
    private Integer version;
    private int retryCount;
    @Enumerated(EnumType.STRING)
    private BeneficiaryType beneficiaryType;
    private String beneficiaryId;
    @Convert(converter = GratificationConvertor.class)
    private GratificationData primaryGratification;
    @Convert(converter = GratificationScheduleConverter.class)
    private GratificationSchedule scheduleGratification;
    private String referenceId;
    private String redemptionType;
    private String clientId;

    // 所有getter和setter方法
    // toString方法
}

可行解决方案 #

1. 利用JPA实体管理器判断变更 #

JPA的EntityManager（Hibernate实现）提供了获取实体持久化状态的方法，可直接对比修改前后的状态差异：

@Autowired
private EntityManager entityManager;

public void processAndSave(Long id) {
    GratificationEntityTask obj = repository.findById(id).orElseThrow();
    // 提前初始化懒加载属性（如果有）
    Hibernate.initialize(obj);
    // 获取实体原始快照
    Object[] originalState = ((Session) entityManager.getDelegate()).getPersistenceContext().getEntry(obj).getLoadedState();
    process(obj);
    // 获取修改后的状态
    Object[] currentState = ((Session) entityManager.getDelegate()).getPersistenceContext().getEntry(obj).getCurrentState();
    
    // 对比状态数组判断是否有变更
    boolean hasChanges = !Arrays.equals(originalState, currentState);
    if (hasChanges) {
        repository.save(obj);
    }
}

2. 自定义字段变更跟踪 #

在实体类中通过重写setter方法，主动标记字段是否被修改：

@Entity
@Table(name = "gratification_entity_task")
// 保留原有其他注解
public class GratificationEntityTask {
    // 新增瞬态字段跟踪变更
    @Transient
    private boolean hasChanges = false;

    // 重写setter，修改时标记变更
    public void setStatus(TaskStatus status) {
        if (!Objects.equals(this.status, status)) {
            this.status = status;
            hasChanges = true;
        }
    }

    public void setInfo(Info info) {
        if (!Objects.equals(this.info, info)) {
            this.info = info;
            hasChanges = true;
        }
    }

    // 其他setter方法同理实现对比逻辑...

    // 提供判断方法
    public boolean hasModifications() {
        return hasChanges;
    }

    // 保存后重置标记
    public void resetChanges() {
        hasChanges = false;
    }
}

使用时直接调用判断方法：

GratificationEntityTask obj = repository.findById(id).orElseThrow();
process(obj);
if (obj.hasModifications()) {
    repository.save(obj);
    obj.resetChanges();
}

3. 调整updated_at的维护逻辑 #

当前updated_at被MySQL和Spring JPA双重维护，可关闭其中一个避免无意义更新：

方案A：关闭MySQL自动更新

修改表结构，移除ON UPDATE CURRENT_TIMESTAMP，完全由Spring Data JPA审计维护：

ALTER TABLE `username` MODIFY COLUMN `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP;

确保启动类添加@EnableJpaAuditing，此时只有实体字段变更时，@LastModifiedDate才会更新updated_at。

方案B：关闭Spring JPA自动更新

移除实体类的@LastModifiedDate和@EntityListeners(AuditingEntityListener.class)，仅由MySQL维护updated_at，同时结合@DynamicUpdate确保只更新变更字段：

@Entity
@Table(name = "gratification_entity_task")
@DynamicUpdate // 仅生成包含变更字段的UPDATE语句
public class GratificationEntityTask {
    // 去掉@LastModifiedDate注解
    private Date updatedAt;
    // 其他字段定义不变
}

4. 自定义更新Query精确控制 #

针对特定字段编写带条件的更新Query，仅当字段实际变更时执行：

public interface GratificationEntityTaskRepository extends JpaRepository<GratificationEntityTask, Long> {
    @Modifying
    @Query("UPDATE GratificationEntityTask t SET t.status = :status, t.updatedAt = CURRENT_TIMESTAMP WHERE t.id = :id AND t.status != :status")
    int updateStatusIfChanged(@Param("id") Long id, @Param("status") TaskStatus status);
}

这种方式需针对每个可能变更的字段编写对应方法，优点是精确控制更新触发条件。

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