Hibernate SELECT查询触发ConstraintViolationException：缓存INSERT语句所致

为什么SELECT查询会触发ConstraintViolationException？ #

这是Hibernate的自动刷新（Auto-flush）机制导致的：Hibernate在执行JPQL/HQL这类查询前，会自动将当前Session一级缓存中所有未提交的持久化操作（INSERT/UPDATE/DELETE）同步到数据库，目的是保证查询能获取到最新的一致数据。

你的场景中，执行这个SELECT之前，Session缓存里已经存在一条针对TABLE_B的INSERT操作，且该操作的ID字段为NULL，违反了数据库的非空约束，因此在自动flush阶段抛出了异常——并非SELECT本身导致的错误。

解决方法 #

1. 排查未提交操作的来源 #

回溯调用该SELECT方法的上下文，检查是否有代码创建了TABLE_B对应的实体对象，但未正确设置ID（比如遗漏主键赋值、主键生成策略配置错误）。即使你没有显式调用save()/persist()，如果实体被Session托管（比如通过级联关联、或之前的持久化操作未提交），Hibernate也会在flush时尝试将其插入数据库。

2. 清空Session缓存（丢弃无效变更） #

如果确认这些未提交的操作是无效的，可以在执行SELECT前清空Session缓存，阻止Hibernate执行这些操作：

// 获取当前Session
Session session = entityManager.unwrap(Session.class);
// 清空缓存，所有未提交的变更会被丢弃
session.clear();

3. 临时禁用自动刷新 #

针对当前查询禁用自动刷新，让Hibernate在执行SELECT时不触发flush：

TypedQuery<RfaSchoolWorkflow> query = createQuery("select rfa from RfaSchoolWorkflow rfa where rfa.schoolCasePrepForm.casePrepForm = :cpf");
query.setParameter("cpf", model);
// 设置查询的刷新模式为NEVER，不自动flush缓存
query.setFlushMode(FlushMode.NEVER);
return QueryUtil.single(query);

注意：这种方式可能导致查询结果无法反映缓存中未提交的变更，需根据业务场景判断是否适用。

4. 检查实体主键配置 #

确认TABLE_B对应的实体类中ID字段的映射配置是否正确：

• 如果是数据库自增主键，需添加@GeneratedValue(strategy = GenerationType.IDENTITY)；
• 如果是序列生成主键，需配置@GeneratedValue(strategy = GenerationType.SEQUENCE)并指定对应序列；
• 如果是手动赋值主键，要确保实体被Session托管前已经设置了非空的ID值。

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