如何配置Quarkus与Hibernate ORM强制读取操作必须开启事务？

针对你遇到的Panache无事务读导致数据不一致、且无法通过全局配置直接强制事务的问题，以下是几个可行的解决方向：

1. 全局事务严格模式+兼容Liquibase #

TransactionRequirement.STRICT确实会强制所有CDI方法必须在事务中执行，但可以通过给Liquibase的Bean单独配置事务属性来绕过限制：

步骤： #

• 在application.properties中开启严格事务要求：

  quarkus.transaction.requirement=STRICT
  

• 自定义Liquibase工厂Bean，指定其事务需求为NOT_SUPPORTED，让迁移操作不受全局严格模式约束：

  import io.quarkus.liquibase.LiquibaseFactory;
  import jakarta.enterprise.context.ApplicationScoped;
  import jakarta.enterprise.inject.Produces;
  import jakarta.transaction.Transactional;
  import jakarta.transaction.TransactionRequirement;
  
  @ApplicationScoped
  public class LiquibaseTxConfig {
  
      @Produces
      @Transactional(TransactionRequirement.NOT_SUPPORTED)
      public LiquibaseFactory liquibaseFactory() {
          return new LiquibaseFactory();
      }
  }
  

  这样业务代码（包括Panache的读操作）必须在事务中执行，而Liquibase迁移可以正常运行。

2. 自定义Panache仓库基类拦截无事务读 #

如果不想全局强制事务，可通过封装Panache仓库，在所有读操作前检查事务状态，无事务则抛出异常：

import io.quarkus.hibernate.orm.panache.PanacheRepository;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.transaction.TransactionManager;
import javax.naming.InitialContext;

@ApplicationScoped
public abstract class TxRequiredPanacheRepo<T> implements PanacheRepository<T> {

    private final TransactionManager txManager;

    public TxRequiredPanacheRepo() {
        try {
            txManager = (TransactionManager) new InitialContext().lookup("java:jboss/TransactionManager");
        } catch (Exception e) {
            throw new RuntimeException("Failed to get TransactionManager", e);
        }
    }

    // 重写所有读操作方法，先校验事务
    @Override
    public T findById(Object id) {
        requireActiveTx();
        return super.findById(id);
    }

    @Override
    public long count() {
        requireActiveTx();
        return super.count();
    }

    // 按需重写findAll、list、find等其他读方法

    private void requireActiveTx() {
        try {
            if (txManager.getStatus() != TransactionManager.STATUS_ACTIVE) {
                throw new IllegalStateException("Read operations must run in an active transaction");
            }
        } catch (Exception e) {
            throw new RuntimeException("Failed to check transaction status", e);
        }
    }
}

之后所有业务仓库都继承这个基类，就能强制读操作必须在事务中执行。

3. Hibernate层面禁用非事务读 #

通过Hibernate配置关闭自动提交，让非事务环境下无法执行读操作：
在application.properties中添加：

quarkus.hibernate-orm.hibernate.connection.autocommit=false

这个配置会让Hibernate拒绝非事务的数据库操作，但需注意测试Liquibase是否受影响——如果迁移失败，可针对测试环境单独调整该配置，或结合方案1的Liquibase兼容处理。

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