Spring事务失效的十大陷阱与深度解析

yiridancan

已于 2025-03-31 16:53:20 修改

阅读量1k

点赞数 29

分类专栏： Spring 文章标签： spring java 后端

于 2025-03-31 16:50:19 首次发布

本文链接：https://blog.youkuaiyun.com/yiridancan/article/details/146842725

版权

Spring 专栏收录该内容

6 篇文章

订阅专栏

Spring 事务传播机制详解：7 种类型对比+实际场景（附避坑指南）

在Spring框架中，事务管理是保证数据一致性的核心功能之一。然而，由于动态代理、异常处理、配置细节等因素，开发者常会遇到事务失效的“坑”。本文将结合源码、场景案例和解决方案，深入分析Spring事务失效的常见原因，并提供系统性的排查思路。

一、方法可见性：非`public`方法的事务陷阱

1.1 问题根源

Spring事务基于AOP动态代理实现。默认情况下，@Transactional通过代理对象拦截目标方法，而CGLIB代理无法代理非public方法，JDK动态代理则直接忽略这类方法。

1.2 源码验证

查看AbstractFallbackTransactionAttributeSource类中的computeTransactionAttribute方法：

protected TransactionAttribute computeTransactionAttribute(Method method, Class<?> targetClass) {
    if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
        return null; // 非public方法直接返回null，不处理事务
    }
    // ...
}

1.3 解决方案

将事务方法改为public
若必须使用非public方法，需切换为AspectJ模式（非Spring AOP）：

@EnableTransactionManagement(mode = AdviceMode.ASPECTJ)

二、自调用问题：代理对象的内外之别

2.1 现象分析

当一个类中的方法A调用本类的方法B（带@Transactional）时，由于调用的是this.methodB()而非代理对象，事务注解失效。

2.2 案例代码

@Service
public class OrderService {
    public void createOrder() {
        this.updateInventory(); // 直接调用，事务失效！
    }
    
    @Transactional
    public void updateInventory() {
        // 扣减库存
    }
}

2.3 解决方案

注入自身代理对象（需开启@EnableAspectJAutoProxy(exposeProxy = true)）：

@Autowired
private OrderService selfProxy;

public void createOrder() {
    selfProxy.updateInventory(); // 通过代理对象调用
}

使用AopContext获取代理：

public void createOrder() {
    ((OrderService) AopContext.currentProxy()).updateInventory();
}

三、异常处理：回滚规则的隐秘逻辑

3.1 默认行为

Spring默认只在抛出RuntimeException和Error时回滚事务，检查型异常（如IOException）不会触发回滚。

3.2 常见错误场景

捕获异常未抛出：

@Transactional
public void update() {
    try {
        jdbcTemplate.update("...");
    } catch (DataAccessException e) {
        // 吞掉异常，事务提交！
    }
}

抛出错误异常类型：

@Transactional
public void save() throws Exception { // 抛出检查型异常
    // ...
    throw new SQLException("DB error"); 
}

3.3 精准控制回滚

指定回滚异常：

@Transactional(rollbackFor = {SQLException.class, MyBizException.class})

排除不回滚的异常：

@Transactional(noRollbackFor = IllegalArgumentException.class)

四、数据库引擎：事务的底层依赖

4.1 MyISAM与InnoDB对比

特性	MyISAM	InnoDB
事务支持	❌ 不支持	✔️ 支持
行级锁	❌ 表锁	✔️ 行锁
崩溃恢复	较弱	强（Redo Log）

4.2 检查与修改引擎

-- 查看表引擎
SHOW TABLE STATUS LIKE 'your_table';

-- 修改为InnoDB
ALTER TABLE your_table ENGINE=InnoDB;

五、事务传播行为的“多米诺效应”

5.1 传播行为详解

传播类型	说明
REQUIRED (默认)	当前有事务则加入，无则新建
REQUIRES_NEW	始终新建事务，挂起当前事务（独立提交）
NESTED	嵌套事务，外层回滚会导致内层回滚
NOT_SUPPORTED	非事务执行，挂起当前事务

5.2 典型错误案例

@Transactional
public void parentMethod() {
    childMethod(); // 若childMethod使用NOT_SUPPORTED，parent的事务被挂起
}

@Transactional(propagation = Propagation.NOT_SUPPORTED)
public void childMethod() {
    // 此处的操作无事务保护！
}

六、多数据源事务的配置陷阱

6.1 多事务管理器配置

@Configuration
public class DataSourceConfig {
    @Bean
    @Primary
    public PlatformTransactionManager txManager1(DataSource ds1) {
        return new DataSourceTransactionManager(ds1);
    }

    @Bean
    public PlatformTransactionManager txManager2(DataSource ds2) {
        return new DataSourceTransactionManager(ds2);
    }
}

6.2 使用指定事务管理器

@Transactional("txManager2")
public void multiDataSourceUpdate() {
    // 操作第二个数据源
}

七、调试技巧：追踪事务生命周期

7.1 开启Spring事务日志

logging.level.org.springframework.jdbc=DEBUG
logging.level.org.springframework.transaction=TRACE

7.2 使用编程式事务检查

void checkTransactionActive() {
    boolean isActive = TransactionSynchronizationManager.isActualTransactionActive();
    System.out.println("Transaction active: " + isActive);
}