Quarkus应用如何实现全请求周期EntityManager保持开启并支持多次提交

方案1：JPA标准实现（请求作用域EntityManager + 编程式事务） #

该方案完全符合JPA规范，无需依赖Hibernate特有能力，仅需少量配置即可实现需求：

1. 自定义请求作用域EntityManager生产者，绑定EntityManager生命周期到当前请求

   import jakarta.enterprise.context.RequestScoped;
   import jakarta.enterprise.inject.Produces;
   import jakarta.persistence.EntityManager;
   import jakarta.persistence.PersistenceContext;
   
   @RequestScoped
   public class RequestScopedEMProducer {
       // 替换为自己的持久化单元名称，单数据源场景可省略unitName参数
       @PersistenceContext(unitName = "default")
       private EntityManager entityManager;
   
       @Produces
       @RequestScoped
       public EntityManager produceRequestScopedEM() {
           return entityManager;
       }
   }
   

2. 业务层注入请求作用域EntityManager和UserTransaction手动控制事务边界

   import jakarta.inject.Inject;
   import jakarta.transaction.UserTransaction;
   import jakarta.enterprise.context.RequestScoped;
   
   @RequestScoped
   public class BusinessService {
       @Inject
       private EntityManager em;
       @Inject
       private UserTransaction tx;
   
       public void processRequest() throws Exception {
           // 第一阶段：提交初始请求记录
           tx.begin();
           RequestLog requestLog = new RequestLog();
           em.persist(requestLog);
           tx.commit();
           // 事务提交后EntityManager未关闭，requestLog仍处于托管状态
   
           // 第二阶段：执行业务操作并提交变更
           tx.begin();
           requestLog.setStatus("PROCESSING");
           // 直接修改托管实体即可，无需调用merge方法，后续事务自动触发脏检查更新
           BizEntity entity = em.find(BizEntity.class, 1001L);
           entity.setBizField("updated value");
           // 可选：提前将变更刷入数据库，无需等待事务提交
           em.flush();
           tx.commit();
   
           // 最终阶段：完成最后提交
           tx.begin();
           requestLog.setStatus("FINISHED");
           tx.commit();
       }
   }
   

方案2：Hibernate扩展持久化上下文实现 #

如果需要更强的托管状态控制，可使用Hibernate支持的扩展持久化上下文，只需修改生产者的注入配置：

// 将PersistenceContext类型指定为EXTENDED
@PersistenceContext(unitName = "default", type = PersistenceContextType.EXTENDED)
private EntityManager entityManager;

扩展持久化上下文天生支持事务提交后保留实体托管状态，适配你当前的业务场景更便捷。

关键注意事项 #

• 不要在请求线程外调用请求作用域的EntityManager，避免上下文丢失异常
• 分阶段提交属于多事务场景，需要自行实现业务补偿逻辑，保证后续步骤失败时已提交数据的一致性
• 分阶段执行的业务方法不要添加@Transactional注解，避免方法级事务覆盖你手动控制的事务边界
• 请求结束时CDI会自动销毁请求作用域的EntityManager，无需手动关闭

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