@Transactional注解为何仅在类层级声明时生效？

底层机制 #

Spring的声明式事务完全基于动态代理实现，只有经过Spring容器生成的代理对象发出的方法调用，才会触发事务增强逻辑。原始对象发起的this调用、未被代理规则匹配的方法，都不会进入事务流程。

• 类层级标注的@Transactional，会给当前类下所有非private的public方法默认套用配置的事务规则，代理对象拦截到任意public方法调用时，都会按照配置开启/加入事务。
• 仅在方法上标注的@Transactional，只会针对被标注的单个方法做事务增强，类上没有注解时，其他方法不会触发任何事务逻辑。

对应你场景的问题根源 #

你移除类级注解、仅在saveAndCommit方法上加注时报事务缺失异常，本质是调用链路没有真正触发saveAndCommit上的事务增强，最常见的原因是存在类内部自调用：

1. 当@Transactional加在类层级时，所有外部调用的类内public方法都会被代理拦截，只要外部入口方法被代理开启了事务，后续方法内部的this调用（包括私有方法、静态工具类方法调用）都会共享同一个线程绑定的事务上下文，自然不会报错。
2. 当你移除类上的注解、仅在saveAndCommit方法上加注时，如果外部实际调用的是类内其他public方法（比如对外暴露的执行入口process()），这个方法本身没有事务注解，代理调用时不会开启事务；后续这个方法内部通过this.saveAndCommit()发起调用时，拿到的是原始对象而非代理对象，saveAndCommit上的事务注解完全不会被触发，整个链路从始至终没有开启事务，执行到数据库更新/删除操作时就会抛出TransactionRequiredException。

容易踩的其他同类坑点 #

• 被@Transactional标注的方法必须是public修饰，private/protected方法上的注解不会被代理织入，完全不生效。
• 注意导入的注解包：org.springframework.transaction.annotation.Transactional是Spring代理会识别的标准注解，javax.transaction.Transactional的触发规则和前者存在差异，混用容易出问题。
• 只要入口方法开启了事务，方法内调用的私有方法、静态工具类方法不需要额外加事务注解，只要操作的是Spring管理的JPA资源，都会自动加入当前线程的事务上下文。像你代码里的DeleteManager.saveAll()静态方法，本身就算不加事务注解，也能正常共享外层的事务连接。

可选解决方案 #

• 如果Inserter类的所有公开方法都需要走REQUIRED传播级别的事务，直接把@Transactional加在类层级是最合理的选择，不存在“粗粒度带来额外性能损耗”之类的副作用。
• 如果必须使用方法级别的注解，需要保证所有调用saveAndCommit的入口，都是从Spring容器获取的代理对象直接发起的调用，杜绝类内部this自调用。如果存在自调用场景，可通过以下方式调整：
  • 把需要事务保护的逻辑抽到独立的Spring Bean中，注入后通过bean代理对象调用
  • 在类内部注入自身的代理对象，通过注入的代理对象调用saveAndCommit方法，代替原始的this调用
  • 替换为AspectJ织入模式，实现类内部自调用场景下的事务增强

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