企业官网建设流程全解析

前段时间帮同事排查一个线上问题：用户下单后，扣减库存和生成订单明明在同一个方法里，结果订单创建成功了，库存却没扣掉，数据库里出现了超卖。代码翻来覆去看了几遍，逻辑没问题，事务注解也加了——@Transactional赫然写在了一个private方法上。

这不是个例。几乎每个 Spring 项目里，都有人踩过这个坑。今天我们就来聊聊，为什么@Transactional加在 private 方法上会失效，以及正确的做法是什么。

一、Spring 事务的底层是动态代理

Spring 的声明式事务，本质上是 AOP 的一种应用。当你在某个 Bean 的方法上加了@Transactional，Spring 会为这个 Bean 创建一个代理对象。外部调用者拿到的是代理对象，代理对象在调用目标方法之前开启事务，方法执行完后提交或回滚。

代理方式有两种：JDK 动态代理和 CGLIB 动态代理。JDK 动态代理基于接口，要求目标类实现接口；CGLIB 通过继承目标类生成子类，覆盖父类方法来实现增强。无论哪种方式，都有一个共同的前提：被增强的方法必须能够被代理对象“拦截”到。

private 方法恰恰无法满足这个前提。JDK 动态代理只能代理接口中声明的方法，而接口方法必须是 public 的；CGLIB 虽然可以代理类，但它生成的子类无法覆盖父类的 private 方法，因为 private 方法对子类不可见。换句话说，代理对象根本“看不到”这个 private 方法，自然也就无法为它开启事务。

二、Spring 的官方态度

Spring 官方文档里写得很清楚：

When using proxies, you should apply the@Transactionalannotation only to methods with public visibility. If you do annotate protected, private or package-visible methods with@Transactional, no error is raised, but the annotated method does not exhibit the configured transactional settings.

翻译过来就是：使用代理时，@Transactional只应该加在 public 方法上。如果你加在 protected、private 或包可见的方法上，Spring 不会报错，但事务配置不会生效。注意最后一句——“不会报错”，这才是最坑的地方。代码照常运行，日志风平浪静，只有数据在悄悄出错。

三、更隐蔽的自调用问题

比 private 方法更隐蔽的，是同一个类内部的 public 方法自调用。比如：

public void createOrder() { // 一些业务逻辑 deductStock(); // 直接调用本类方法 } @Transactional public void deductStock() { // 扣减库存 }

这里deductStock是 public 的，@Transactional也加了，但事务依然不会生效。原因在于，createOrder内部调用deductStock时，用的是this引用，而不是代理对象。事务增强逻辑只存在于代理对象中，this调用直接走原始对象，绕过了代理。

同理，如果把deductStock改成 private，然后从createOrder里调用，问题一模一样，甚至更糟——因为 private 方法从一开始就不该期望有事务。

四、正确的解决思路

第一，把@Transactional加在 public 方法上。这是最简单也最推荐的做法。如果业务逻辑集中在私有方法里，可以把它抽到一个独立的 Spring Bean 中，通过注入的方式调用。这样调用走的是代理对象，事务自然生效。

第二，如果确实需要自调用且事务生效，可以用AopContext.currentProxy()。但这需要开启exposeProxy = true，并且代码会变得不够优雅，一般不推荐。

第三，使用编程式事务。如果逻辑复杂、嵌套较多，直接注入TransactionTemplate，手动控制事务边界。这种方式虽然代码量稍多，但事务范围一目了然，不容易出错。

第四，注意方法可见性。除了 private，protected 和包级私有方法上的@Transactional同样不会生效。统一使用 public 修饰需要事务的方法，是最省心的约定。

五、如何快速排查

如果怀疑事务没生效，可以在配置中打开事务日志：

logging: level: org.springframework.transaction: DEBUG

如果看到No need to create transaction for ...或者根本没有Creating new transaction的日志，就说明事务切面没有拦截到目标方法。此时优先检查：方法是不是 public？是不是自调用？注解是不是加在了 private 方法上？

结语

@Transactional加在 private 方法上，是一个典型的“静默失败”。它不报错、不抛异常，却让事务形同虚设，最终导致数据不一致。理解 Spring AOP 的代理机制，记住“public、非自调用”这两个关键词，就能避开这个坑。下次写事务注解时，不妨多看一眼方法签名——那个 private，可能正在悄悄毁掉你的数据。