Spring @Transactional 注解详解

3.1 value / transactionManager

当应用中有多个 PlatformTransactionManager 时，通过该属性指定使用哪个事务管理器。

@Transactional("orderTransactionManager")
public void processOrder() {
    ...
}

3.2 propagation（传播行为）

解析：

• REQUIRES_NEW 内部事务的提交/回滚不影响外部事务，反之亦然。
• NESTED 依赖于底层数据库的保存点（savepoint）支持，允许部分回滚。并非所有数据库都支持。

3.3 isolation（隔离级别）

3.4 timeout

设置事务的超时秒数。超过时间，事务会自动回滚。

3.5 readOnly

标记事务为只读，有助于数据库优化（如 Oracle 会跳过锁获取），但需确保事务内没有写操作。

3.6 rollbackFor / noRollbackFor

默认情况下，Spring 事务只在遇到运行时异常（RuntimeException 及其子类）和 Error 时回滚，检查型异常（如 IOException）不会触发回滚。通过 rollbackFor 可以指定某些检查异常也应回滚，或通过 noRollbackFor 指定某些运行时异常不回滚。

@Transactional(rollbackFor = Exception.class)
// 任何异常都回滚
public void update() throws Exception {
    // ...
}

@Transactional(noRollbackFor = IllegalArgumentException.class)
public void process() {
    // ...
}

4. 工作原理：Spring 声明式事务的实现机制

Spring 的声明式事务基于 AOP（面向切面编程） 实现，核心组件包括：

1. 事务管理器（PlatformTransactionManager）：如 DataSourceTransactionManager、JpaTransactionManager。
2. 事务拦截器（TransactionInterceptor）：AOP 增强，负责在目标方法前后执行事务逻辑。
3. 事务属性来源（TransactionAttributeSource）：解析 @Transactional 注解，获取事务配置。
4. 代理对象：通过 JDK 动态代理或 CGLIB 生成代理对象，包裹目标方法。

4.1 执行流程

1. 调用方获取的是 Spring 生成的代理对象（而非原始 Bean）。
2. 代理对象中的 TransactionInterceptor 在方法调用前，根据 @Transactional 配置开启事务。
3. 执行目标方法（业务逻辑）。
4. 方法执行后：
   • 如果方法正常返回，则提交事务。
   • 如果方法抛出异常，根据配置决定回滚或提交。
5. 最终返回结果给调用方。

4.2 源码层面

• TransactionInterceptor 实现 MethodInterceptor，在 invoke() 方法中调用 invokeWithinTransaction()。
• invokeWithinTransaction() 根据事务管理器、传播行为等处理事务开启、提交、回滚。

5. 事务不生效的常见原因

5.1 自调用问题

@Service
public class UserService {
    public void outer() {
        inner(); // 直接调用，this 是原始对象，而非代理对象
    }

    @Transactional
    public void inner() {
        // 数据库操作
    }
}

原因：outer() 中的 inner() 是通过 this 直接调用的，没有经过代理对象，因此事务注解无效。

解决方法：

• 将方法拆分为不同 Bean，通过注入调用。
• 使用 AopContext.currentProxy() 获取当前代理对象：

((UserService) AopContext.currentProxy()).inner();

需要配置 @EnableAspectJAutoProxy(exposeProxy = true)。

5.2 方法不是 public

@Transactional 默认只对 public 方法生效。如果标注在非 public 方法上，Spring 不会应用事务。

5.3 数据库不支持事务

例如 MySQL 的 MyISAM 引擎不支持事务，需要使用 InnoDB。

5.4 事务管理器未配置或配置错误

Spring Boot 默认会配置事务管理器，但多数据源时需要显式指定。

5.5 异常被捕获

@Transactional
public void method() {
    try {
        // 数据库操作
        throw new RuntimeException();
    } catch (Exception e) {
        // 异常被捕获，没有抛出
    }
}

事务拦截器无法感知异常，因此不会回滚。解决方法：在 catch 块中重新抛出异常，或通过 TransactionAspectSupport.currentTransactionStatus().setRollbackOnly() 手动标记回滚。

5.6 传播行为配置不当

例如在 REQUIRED 传播下，内部事务抛异常，外部事务也回滚；但在 REQUIRES_NEW 下，内部事务回滚不会影响外部事务。

6. 事务传播行为实践案例

6.1 REQUIRED（默认）

@Service
public class OuterService {
    @Autowired
    private InnerService innerService;

    @Transactional
    public void outer() {
        innerService.inner(); // 加入外部事务
        // 如果 inner 抛异常，outer 也会回滚
    }
}

@Service
public class InnerService {
    @Transactional(propagation = Propagation.REQUIRED)
    public void inner() {
        // 数据库操作
    }
}

6.2 REQUIRES_NEW

@Service
public class OuterService {
    @Autowired
    private InnerService innerService;

    @Transactional
    public void outer() {
        innerService.inner(); // 新事务
        // inner 回滚不影响 outer
    }
}

@Service
public class InnerService {
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void inner() {
        // 数据库操作
    }
}

6.3 NESTED（需要数据库支持保存点）

@Transactional(propagation = Propagation.NESTED)
public void inner() {
    // 如果外部事务存在，则在嵌套事务内执行，可部分回滚
}

7. 隔离级别与并发问题

7.1 并发问题类型

• 脏读：读取到其他事务未提交的数据。
• 不可重复读：同一事务内两次读取同一数据，结果不一致（数据被其他事务修改并提交）。
• 幻读：同一事务内两次查询返回的记录数不同（其他事务插入或删除了记录）。

7.2 隔离级别选择

注意：MySQL InnoDB 默认使用 REPEATABLE_READ，并通过 MVCC 机制在一定程度上避免了幻读。

8. Spring Boot 中的 @Transactional

8.1 自动配置

Spring Boot 自动配置了 DataSourceTransactionManager 和 JpaTransactionManager，无需额外配置。只需在启动类上添加 @EnableTransactionManagement（实际上 Spring Boot 会自动启用，但显式加上也无妨）。

8.2 多数据源配置

@Bean
@Primary
public PlatformTransactionManager primaryTransactionManager(@Qualifier("primaryDataSource") DataSource dataSource) {
    return new DataSourceTransactionManager(dataSource);
}

@Bean
public PlatformTransactionManager secondaryTransactionManager(@Qualifier("secondaryDataSource") DataSource dataSource) {
    return new DataSourceTransactionManager(dataSource);
}

使用时通过 value 属性指定：

@Transactional("secondaryTransactionManager")
public void method() {
    ...
}

9. 最佳实践总结

1. 明确事务边界：事务应尽量短小，避免在事务内执行耗时的网络请求、文件操作等。
2. 合理选择传播行为：理解每种传播行为的含义，避免误用导致数据不一致。
3. 异常处理：不要随意捕获异常而不抛出，否则事务不会回滚。
4. 只读事务优化：对于只读操作，设置 readOnly=true 可提升性能。
5. 私有方法无效：确保 @Transactional 标注在 public 方法上。
6. 自调用问题：通过注入代理对象或使用 AopContext.currentProxy() 解决。
7. 测试事务：在单元测试中，可使用 @Transactional 和 @Rollback 实现测试数据自动回滚。
8. 使用默认回滚规则：通常建议所有异常都回滚，除非明确不需要回滚的场景。

10. 总结

@Transactional 是 Spring 声明式事务的核心注解，通过简洁的配置即可实现强大的事务管理。理解其属性、传播行为、隔离级别以及工作原理，对于编写健壮的应用程序至关重要。同时，注意避免常见陷阱（如自调用、异常被吞），才能确保事务按预期生效。