Spring @Transactional 注解详解:从入门到避坑

一、为什么需要事务?

想象一个下单场景:

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

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

二、快速使用

java 复制代码
@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_COMMITTED、REPEATABLE_READ
rollbackFor 指定回滚的异常类型 Exception.class
noRollbackFor 指定不回滚的异常 IllegalArgumentException.class
timeout 事务超时时间(秒) -1(默认无限制)
readOnly 是否为只读事务 true / false

3.1 propagation 传播行为

java 复制代码
@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。

java 复制代码
// 错误示范: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:同类内部调用(最高频)

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

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

解决:

java 复制代码
@Autowired
private OrderService orderService;

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

场景 2:异常被吞掉

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

解决:

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

场景 3:异常类型不匹配

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

场景 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,事务尽量短
相关推荐
Forget the Dream2 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
bksczm2 小时前
Redis Cluster 分片集群详解:槽路由、故障判定与扩缩容
数据库·redis·分布式
行百里er2 小时前
【Spring Insight 技术分享】跨服务调用链路是怎么串起来的?
后端·spring·开源
火山引擎和TA的超级拍档们2 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
源动力技术栈3 小时前
C# 集合类型全览:从 List<T> 到 FrozenDictionary,配一组实测数据
后端
aleimu3 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
货拉拉技术3 小时前
AI Agent 如何进入实时交易系统:货拉拉的三个实践与一套工程方法论
后端·架构·agent
我是谁的程序员3 小时前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios
华为云开发者联盟3 小时前
TaurusDB 慢 SQL 智能诊断:用大模型辅助调优
后端
ServBay3 小时前
AI编程越来越强,为什么软件漏洞却是一个没少?MySQL又爆高危漏洞了
后端·mysql