Spring Boot+Hibernate JPA插入预取ID数据时触发JpaObjectRetrievalFailureException

问题根因 #

1. ID生成策略不匹配：实体类@Id字段未配置生成策略，但数据库表ID默认通过序列workflow_testcase_id_seq自动生成。手动预取ID并设置到实体后，Hibernate无法直接判断该实体是新实体（需插入）还是已存在实体（需更新），会先执行SELECT语句检查ID是否存在。
2. 并发竞态条件：在Hibernate执行SELECT检查到ID不存在，到执行INSERT的间隙，另一个会话可能已通过自动序列分配占用了该预取ID。此时当前会话的INSERT会因主键唯一约束失败，后续Hibernate尝试加载该ID实体时，找不到对应记录，抛出EntityNotFoundException，最终触发事务回滚导致数据丢失。

解决方案 #

方案1：让JPA统一管理序列ID（推荐） #

直接配置实体类的ID生成策略，让Hibernate自动从数据库序列获取ID，彻底避免手动预取的并发问题。

修改实体类ID字段：

@Entity
@Table(name = "workflow_testcase")
@ToString
public class WorkflowTestCase {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "workflow_testcase_seq")
    @SequenceGenerator(name = "workflow_testcase_seq", sequenceName = "workflow_testcase_id_seq", allocationSize = 1)
    private Long id;

    // 其他字段及getter/setter不变
}

简化插入方法，无需手动设置ID：

@Transactional
WorkflowTestCase insertTestCase(String name) {
    WorkflowTestCase workflowTestCase = new WorkflowTestCase();
    workflowTestCase.setName(name);
    return workflowTestCaseRepository.save(workflowTestCase);
}

方案2：保留手动预取，确保插入原子性 #

若业务必须提前获取ID，需保证预取ID与插入操作的原子性，并强制Hibernate执行插入而非更新：

1. 预取ID时必须使用nextval获取序列下一个唯一值：

SELECT nextval('workflow_testcase_id_seq');

2. 使用EntityManager.persist()替代Repository.save()，明确告知Hibernate这是新实体，跳过前置查询：

@Autowired
private EntityManager entityManager;

@Transactional
WorkflowTestCase insertTestCase(Long id, String name) {
    WorkflowTestCase workflowTestCase = new WorkflowTestCase();
    workflowTestCase.setId(id);
    workflowTestCase.setName(name);
    entityManager.persist(workflowTestCase);
    entityManager.flush(); // 立即执行插入，避免延迟导致的竞态
    return workflowTestCase;
}

方案3：捕获主键冲突并重试 #

针对无法避免的并发场景，捕获主键冲突异常，重新预取ID后重试插入：

@Autowired
private JdbcTemplate jdbcTemplate;

@Transactional
WorkflowTestCase insertTestCase(String name) {
    while (true) {
        // 预取唯一ID
        Long id = jdbcTemplate.queryForObject("SELECT nextval('workflow_testcase_id_seq')", Long.class);
        WorkflowTestCase workflowTestCase = new WorkflowTestCase();
        workflowTestCase.setId(id);
        workflowTestCase.setName(name);
        try {
            return workflowTestCaseRepository.save(workflowTestCase);
        } catch (DataIntegrityViolationException e) {
            // 主键冲突，重试
            continue;
        }
    }
}

关键注意事项 #

• 禁止混合使用手动ID分配与自动序列生成：部分代码手动设ID、部分依赖数据库自动生成，极易引发ID冲突。
• 保持序列配置一致：使用@SequenceGenerator时，allocationSize需与PostgreSQL序列的增量值（默认1）匹配，避免ID跳跃或冲突。

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