带@Transactional注解的Spring Bean出现TransactionRequiredException问题

你遇到的这个问题本质是**@Transactional注解未正确生效**，导致EntityManager执行persist操作时没有处于活跃的事务上下文当中。下面按优先级列出几个关键排查方向：

1. 确认Spring已开启事务注解驱动 #

这是最容易被忽略的基础配置——如果没开启注解式事务支持，@Transactional标签完全不会起作用：

• 若使用XML配置，需添加事务驱动和对应的事务管理器：

<!-- 开启注解事务支持 -->
<tx:annotation-driven transaction-manager="jpaTransactionManager"/>

<!-- 配置JPA事务管理器 -->
<bean id="jpaTransactionManager" class="org.springframework.orm.jpa.JpaTransactionManager">
    <property name="entityManagerFactory" ref="entityManagerFactory"/>
</bean>

• 若使用Java Config，需在配置类上添加@EnableTransactionManagement注解：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(basePackages = "your.base.package")
public class PersistenceConfig {
    // 配置EntityManagerFactory等相关Bean
}

2. 检查@Transactional的应用是否规范 #

• 确保注解加在Spring能拦截到的方法/类上：你的SpringBean标注了@Service，会被Spring代理，但要注意：
  • 不要把@Transactional加在private方法上（Spring代理无法拦截私有方法）
  • 若使用默认JDK动态代理，SpringBean最好实现接口；如果不想用接口，需开启CGLIB代理（XML中添加<aop:aspectj-autoproxy proxy-target-class="true"/>，Java Config中设置@EnableTransactionManagement(proxyTargetClass = true)）
• 可以尝试把注解直接加在foo()方法上，明确指定事务属性：

@Service
class SpringBean {
    @PersistenceContext(unitName = someUnitName)
    EntityManager entityManager;

    @Transactional(rollbackFor = Exception.class) // 明确指定回滚规则
    public void foo(){
        entityManager.persist(someEntity);
    }
}

3. 验证Servlet注入的Bean是否为代理对象 #

如果Servlet里拿到的SpringBean不是Spring的代理实例，事务切面就不会生效。你可以在doPost里打印Bean的类名确认：

@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    System.out.println(springBean.getClass().getName()); // 输出类名
    springBean.foo();
}

如果输出的是SpringBean而非类似SpringBean$$EnhancerBySpringCGLIB$$xxxx的代理类，说明Bean未被事务代理包裹，需排查：

• 组件扫描是否覆盖了SpringBean所在的包？
• SpringBeanAutowiringSupport.processInjectionBasedOnCurrentContext(this)是否执行成功？有没有隐藏的异常？

4. 确认事务管理器与EntityManagerFactory的关联 #

如果配置了多个EntityManagerFactory，要确保JpaTransactionManager和@PersistenceContext注入的是同一个实例，必要时在@Transactional中指定事务管理器：

@Transactional(value = "yourSpecificTransactionManager")
public void foo(){
    entityManager.persist(someEntity);
}

5. 检查EntityManager的注入类型 #

你用@PersistenceContext注入的是容器管理的EntityManager，它依赖Spring的事务上下文。如果是手动创建的EntityManager（比如EntityManagerFactory.createEntityManager()），@Transactional也不会生效，但你的代码是注解注入，这一点大概率没问题，可作为兜底排查项。

如果以上步骤都排查后仍未解决，可以补充你的Spring配置文件（XML或Java Config），方便更精准定位问题。

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