SpringBoot 2.7执行DDL遇TransactionRequiredException问题求助

核心原因 #

1. Spring默认注入的EntityManager是共享容器管理实例，不支持手动开启事务，必须由Spring事务管理器管控。
2. DDL语句（如CREATE TABLE）在JPA规范中属于修改类操作，强制要求事务上下文，即使部分数据库支持自动提交DDL，JPA层面仍会校验事务存在性。
3. ApplicationReadyEvent监听方法、定时任务默认不在事务上下文内，若事务注解未被Spring代理正确识别，会导致事务不生效。

解决方案 #

方案一：通过Spring代理确保事务注解生效（推荐）

将DDL执行逻辑抽离到Spring管理的Bean中，利用@Transactional+@Modifying让Spring管控事务：

@Component
public class DdlOperationService {
    @PersistenceContext
    private EntityManager entityManager;

    // 用Spring事务注解管控，确保事务上下文生效
    @Transactional
    @Modifying
    public void createTestTable() {
        String ddlSql = "CREATE TABLE IF NOT EXISTS test_table (id SERIAL PRIMARY KEY, name VARCHAR(255))";
        entityManager.createNativeQuery(ddlSql).executeUpdate();
    }
}

在事件监听类/定时任务中注入该Bean调用：

@Component
public class AppStartupListener implements ApplicationListener<ApplicationReadyEvent> {
    private final DdlOperationService ddlService;

    // 构造注入（避免字段注入）
    public AppStartupListener(DdlOperationService ddlService) {
        this.ddlService = ddlService;
    }

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        ddlService.createTestTable();
    }
}

方案二：手动创建独立EntityManager（无Spring事务依赖）

若不想依赖Spring事务管理，可从EntityManagerFactory创建独立实例，自行管控事务：

@Component
public class DdlOperationService {
    @Autowired
    private EntityManagerFactory entityManagerFactory;

    public void createTestTable() {
        EntityManager em = entityManagerFactory.createEntityManager();
        EntityTransaction tx = null;
        try {
            tx = em.getTransaction();
            tx.begin();
            String ddlSql = "CREATE TABLE IF NOT EXISTS test_table (id SERIAL PRIMARY KEY, name VARCHAR(255))";
            em.createNativeQuery(ddlSql).executeUpdate();
            tx.commit();
        } catch (Exception e) {
            if (tx != null && tx.isActive()) {
                tx.rollback();
            }
            throw e;
        } finally {
            em.close();
        }
    }
}

方案三：定时任务场景的事务配置

在@Scheduled方法中确保事务注解生效，注意方法需为public非final（否则Spring代理失效）：

@Component
public class ScheduledDdlTask {
    @PersistenceContext
    private EntityManager entityManager;

    @Scheduled(cron = "0 0 1 * * ?")
    @Transactional
    @Modifying
    public void addColumnToTestTable() {
        String ddlSql = "ALTER TABLE test_table ADD COLUMN age INT";
        entityManager.createNativeQuery(ddlSql).executeUpdate();
    }
}

关键排查点 #

• 确保@Transactional是org.springframework.transaction.annotation.Transactional（而非JPA原生注解，Spring注解适配性更强）。
• 避免同一类内部调用事务方法（Spring基于代理实现事务，内部调用不会触发代理逻辑）。
• 检查Spring事务管理器是否自动配置完成（PostgreSQL场景下，只要数据源配置正确，Spring会自动生成DataSourceTransactionManager）。

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