Hibernate自动更新实体问题：如何仅显式调用save/update时更新数据库？

这事儿我之前也碰到过，简直摸不着头脑——明明没调用save()或者update()，数据库怎么就悄咪咪变了？其实这是Hibernate的**脏检查（Dirty Checking）**机制在搞鬼，给你捋清楚原因和解决办法：

为什么会自动更新？ #

当你从Hibernate的持久化上下文（Persistence Context）里获取实体时，这个实体处于托管（Managed）状态。Hibernate会默默记录实体加载时的快照，当事务提交时，它会对比当前实体状态和快照：如果发现属性有变化，就自动把这些变化flush到数据库，根本不需要你显式调用更新方法。你修改了实体的属性（哪怕是为了返回前端而移除/调整属性），就触发了这个机制。

解决方案：让Hibernate只在显式调用时更新 #

1. 用DTO代替直接修改实体（最推荐） #

别直接操作从数据库加载的托管实体，而是创建一个数据传输对象（DTO），把你需要返回前端的属性从实体复制到DTO里，然后修改DTO的属性返回给前端。这样原实体完全没被改动，Hibernate自然不会触发自动更新。

示例代码：

// 先获取托管实体
YourEntity entity = entityManager.find(YourEntity.class, id);
// 复制属性到DTO
YourEntityDTO dto = new YourEntityDTO();
dto.setId(entity.getId());
dto.setName(entity.getName());
// 只修改DTO的属性（比如移除敏感字段）
dto.setSensitiveField(null);
// 返回DTO给前端
return dto;

这种方式不仅解决了自动更新的问题，还符合分层架构的最佳实践——避免把数据库实体直接暴露给前端，也能灵活控制返回的字段。

2. 把实体从持久化上下文脱离（Detach） #

如果你不想用DTO，可以在获取实体后，立刻把它从持久化上下文里detach掉，这样Hibernate就不会再追踪它的变化了。

YourEntity entity = entityManager.find(YourEntity.class, id);
// 脱离持久化上下文
entityManager.detach(entity);
// 现在修改实体属性，不会触发自动更新
entity.setSomeField("new value");
return entity;

如果用原生Hibernate Session的话，对应的方法是session.evict(entity)。

3. 以只读模式获取实体 #

在查询实体的时候，设置只读模式，Hibernate会跳过脏检查，即使你修改了实体属性，也不会同步到数据库。

JPA EntityManager方式：

Map<String, Object> hints = new HashMap<>();
hints.put("org.hibernate.readOnly", true);
YourEntity entity = entityManager.find(YourEntity.class, id, hints);

Spring Data JPA方式：

在Repository的查询方法上添加@QueryHints注解：

import org.hibernate.annotations.QueryHints;
import org.springframework.data.jpa.repository.QueryHints;
import org.springframework.data.repository.CrudRepository;

public interface YourEntityRepository extends CrudRepository<YourEntity, Long> {
    @QueryHints(value = { @QueryHint(name = QueryHints.READ_ONLY, value = "true") })
    Optional<YourEntity> findById(Long id);
}

4. 调整FlushMode（慎用） #

Hibernate的FlushMode默认是AUTO，会在事务提交前自动flush变化。你可以把它设置为MANUAL，这样只有当你显式调用entityManager.flush()或者session.flush()时，才会把变化同步到数据库。

// EntityManager方式
entityManager.setFlushMode(FlushModeType.MANUAL);
// 获取实体并修改
YourEntity entity = entityManager.find(YourEntity.class, id);
entity.setSomeField("new value");
// 此时不会自动更新，除非你调用entityManager.flush()

注意：这种方式会影响整个持久化上下文的行为，如果其他地方依赖自动flush的话，可能会出现数据不一致的问题，所以只建议在特定场景下使用。

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