Spring @Transactional整合JPA与JDBC时外键约束违反问题求解

异常触发原因 #

问题核心是Hibernate持久化上下文（一级缓存）的刷写时机与JDBC操作的可见性冲突，具体逻辑如下：

1. Spring Data JPA的CrudRepository.save()方法默认仅将实体存入Hibernate的持久化上下文，不会立刻向数据库发送INSERT语句，默认配置下只有事务提交时才会将所有未同步的变更刷入数据库。
2. 尽管getOrCreateEntity和save方法在同一个事务中，但后续的JdbcOperations走的是原生JDBC调用，直接与数据库交互时，Hibernate还未将新增的Entity记录刷入数据库，导致数据库层面外键约束校验不通过，抛出异常。
3. 从提供的事务日志也可以验证：整个事务过程中没有出现INSERT语句的执行日志，直到事务回滚都没有将实体持久化到数据库。

可行解决方案 #

方案1：本地手动刷写持久化上下文（最推荐，性能影响最小） #

在getOrCreateEntity方法中，将普通save替换为saveAndFlush，强制将变更立刻刷入数据库：

@Transactional
public Entity getOrCreateEntity(long id) {
    final Optional<Entity> optionalEntity = this.crudRepository.findById(id);
    Entity entity;
    
    if (optionalEntity.isEmpty()) {
        entity = new Entity();
        entity.setId(id);
        // 替换save为saveAndFlush，立刻同步到数据库
        entity = this.crudRepository.saveAndFlush(entity);
    } else {
        entity = optionalEntity.get();
    }
    
    return entity;
}

如果你的Repository没有内置saveAndFlush方法，也可以注入EntityManager后手动调用entityManager.flush()。

方案2：全局调整Hibernate刷写策略 #

在项目配置文件中修改Hibernate的刷写模式为AUTO，会在执行查询/原生JDBC操作前自动刷写持久化上下文：

spring:
  jpa:
    properties:
      org.hibernate:
        flushMode: AUTO

该方案为全局配置，会额外增加刷写频率，对性能有轻微影响，适合小项目使用。

方案3：统一数据访问层实现 #

避免在同一个事务中混用JPA和原生JdbcTemplate操作，所有数据库操作统一用JPA实现，或者统一用JdbcTemplate实现，从根源上避免上下文同步问题。

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