Spring @Transactional 注解从入门到避坑指南

 更新时间:2026年05月06日 10:43:35   作者:ffqws_  
文章主要讲解了Spring的@Transactional注解的使用场景、核心属性详解、事务传播行为、隔离级别、回滚配置、底层原理以及失效场景和避免之道,并还给出了最佳实践,感兴趣的朋友跟随小编一起看看吧

一、为什么需要事务?

想象一个下单场景:

  1. 创建订单
  2. 扣减库存
  3. 扣除用户余额

如果第2步成功了,第3步失败,库存已经扣了但钱没扣,数据就乱了。事务的作用就是保证这一组操作要么全成功,要么全失败。

二、快速使用

@Service
public class OrderService {
    @Transactional
    public void submitOrder(OrdersSubmitDTO dto) {
        orderMapper.insert(order);           // 插入订单
        orderDetailMapper.insertBatch(list); // 插入明细
        shoppingCartMapper.clean(userId);    // 清空购物车
    }
}

加了这个注解,方法内所有数据库操作会被包装在一个事务中。任意一步抛异常,Spring 会自动回滚。

三、核心属性详解

属性作用常用值
propagation事务传播行为REQUIRED(默认)、REQUIRES_NEW
isolation隔离级别READ_COMMITTEDREPEATABLE_READ
rollbackFor指定回滚的异常类型Exception.class
noRollbackFor指定不回滚的异常IllegalArgumentException.class
timeout事务超时时间(秒)-1(默认无限制)
readOnly是否为只读事务true / false

3.1 propagation 传播行为

@Transactional(propagation = Propagation.REQUIRED)  // 默认
public void methodA() {
    // 如果已有事务,加入;没有则新建
}
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void methodB() {
    // 挂起当前事务,新建一个独立事务
}

常见场景:日志记录必须保存,不管主业务是否回滚。此时日志方法用 REQUIRES_NEW,主业务回滚不影响日志。

3.2 isolation 隔离级别

@Transactional(isolation = Isolation.READ_COMMITTED)
隔离级别脏读不可重复读幻读
READ_UNCOMMITTED
READ_COMMITTED
REPEATABLE_READ
SERIALIZABLE

MySQL 默认 REPEATABLE_READ,Spring 默认跟随数据库。

3.3 rollbackFor 回滚配置

重点:默认只回滚 RuntimeException 和 Error

// 错误示范:IOException 不会触发回滚!
@Transactional
public void pay() throws IOException {
    // ...
}
// 正确配置:回滚所有异常
@Transactional(rollbackFor = Exception.class)
public void pay() throws IOException {
    // ...
}

四、底层原理(简述)

Spring 通过 AOP 动态代理 实现事务:

  1. 运行时生成目标类的代理对象
  2. 方法执行前开启事务(begin
  3. 方法正常结束则提交(commit
  4. 方法抛异常则回滚(rollback

这也是为什么同类内部调用会导致事务失效——绕过了代理对象。

五、失效场景全解析(避坑指南)

场景 1:同类内部调用(最高频)

@Service
public class OrderService {
    public void createOrder() {
        saveOrder(); // 直接调用,事务失效!
    }
    @Transactional
    public void saveOrder() {
        // ...
    }
}

原因this.saveOrder() 没有走代理对象。

解决

@Autowired
private OrderService orderService;
public void createOrder() {
    orderService.saveOrder(); // 通过注入的代理调用
}

场景 2:异常被吞掉

@Transactional
public void submit() {
    try {
        orderMapper.insert(order);
        payService.pay(); // 抛异常
    } catch (Exception e) {
        log.error("支付失败", e);
        // 异常没抛出去,Spring 认为成功,提交事务!
    }
}

解决

} catch (Exception e) {
    throw new RuntimeException(e);
    // 或者手动回滚:
    // TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
}

场景 3:异常类型不匹配

如 3.3 所述,受检异常(IOExceptionSQLException)默认不回滚。

场景 4:方法非 public

@Transactional 只能作用于 public 方法。

场景 5:数据库引擎不支持

MySQL 的 MyISAM 引擎不支持事务,表必须是 InnoDB

六、最佳实践

  1. 尽量放在 Service 层,不要在 Controller 或 Mapper 上加
  2. 事务方法尽量精简,避免长事务(大事务会锁表、拖垮性能)
  3. 查询操作加 readOnly = true
  4. 明确指定 rollbackFor = Exception.class,避免受检异常漏网
  5. 不要在事务里调外部 HTTP 接口,会拉长事务时间

七、总结

要点记忆口诀
代理调用才生效同类 this. 调用要警惕
异常必须抛出去别在 catch 里默默吞掉
回滚范围要明确rollbackFor = Exception.class
长事务是性能杀手查询加 readOnly,事务尽量短

到此这篇关于Spring @Transactional 注解详解:从入门到避坑的文章就介绍到这了,更多相关Spring @Transactional 注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot如何使用内嵌Tomcat问题

    SpringBoot如何使用内嵌Tomcat问题

    这篇文章主要介绍了SpringBoot如何使用内嵌Tomcat问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • Mybatis使用useGeneratedKeys获取自增主键

    Mybatis使用useGeneratedKeys获取自增主键

    这篇文章主要为大家介绍了Mybatis使用useGeneratedKeys获取自增主键示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-01-01
  • Java多维数组和Arrays类方法总结详解

    Java多维数组和Arrays类方法总结详解

    这篇文章主要介绍了Java多维数组和Arrays类方法总结详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-03-03
  • SpringBoot3实现Gzip压缩优化的技术指南

    SpringBoot3实现Gzip压缩优化的技术指南

    随着 Web 应用的用户量和数据量增加,网络带宽和页面加载速度逐渐成为瓶颈,为了减少数据传输量,提高用户体验,我们可以使用 Gzip 压缩 HTTP 响应,本文将介绍如何在 Spring Boot 3 中实现 Gzip 压缩优化,需要的朋友可以参考下
    2025-04-04
  • 探究MyBatis插件原理以及自定义插件实现

    探究MyBatis插件原理以及自定义插件实现

    这篇文章主要介绍了探究MyBatis插件原理以及自定义插件实现,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-07-07
  • 方法参数属性params,@PathVariable和@RequestParam用法及区别

    方法参数属性params,@PathVariable和@RequestParam用法及区别

    这篇文章主要介绍了方法参数属性params,@PathVariable和@RequestParam用法及区别说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-10-10
  • Java的关键字与标识符小结

    Java的关键字与标识符小结

    这篇文章主要介绍了Java的关键字与标识符,总结整理了Java各种常见的关键字与标识符功能、用法及操作注意事项,需要的朋友可以参考下
    2020-04-04
  • MyBatis-Plus注解配置、条件构造器与自定义SQL的复杂操作实例详解

    MyBatis-Plus注解配置、条件构造器与自定义SQL的复杂操作实例详解

    MyBatis-Plus是一个MyBatis的增强工具,提供快速开发单表CRUD操作等功能,通过依赖引入和配置,可以快速创建和使用Mapper接口进行数据库操作,这篇文章通过实例代码介绍MyBatis-Plus注解配置、条件构造器与自定义SQL的复杂操作,感兴趣的朋友一起看看吧
    2026-02-02
  • Java 实现repalceAll只替换第二个匹配到的字符串

    Java 实现repalceAll只替换第二个匹配到的字符串

    这篇文章主要介绍了Java 实现repalceAll只替换第二个匹配到的字符串,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • 使用maven创建web项目的方法步骤(图文)

    使用maven创建web项目的方法步骤(图文)

    本篇文章主要介绍了使用maven创建web项目的方法步骤,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01

最新评论