2.3 事务控制注解

---

事务控制注解详解

Spring Test 通过事务管理确保测试数据的隔离性，避免测试间的数据污染。以下是与事务控制相关的核心注解及其使用场景，结合代码示例说明其工作机制。

---

1. @Transactional

作用

• 在测试方法或类上启用事务管理：所有数据库操作在事务内执行，默认在方法结束后回滚。
• 隔离测试数据：确保每个测试方法的数据变更不会影响其他测试或持久化到数据库。

使用场景

• 测试数据库增删改操作（如 save、update、delete）。
• 需要验证事务回滚行为的场景（如异常触发回滚）。

示例代码

@ExtendWith(SpringExtension.class)  
@ContextConfiguration(classes = DataSourceConfig.class)  
public class TransactionalTest {  
    @Autowired  
    private JdbcTemplate jdbcTemplate;  

    @Test  
    @Transactional  
    void testInsertWithRollback() {  
        jdbcTemplate.update("INSERT INTO users (name) VALUES ('Alice')");  
        int count = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM users", Integer.class);  
        assertEquals(1, count); // 事务内可见，但最终回滚  
    }  

    @Transactional // 类级别注解，所有方法默认启用事务  
    @SpringJUnitConfig(DataSourceConfig.class)  
    static class ClassLevelTransactionalTest {  
        @Autowired  
        private JdbcTemplate jdbcTemplate;  

        @Test  
        void testClassLevelTransaction() {  
            // 此方法也在事务中执行  
        }  
    }  
}  

注意事项

• 默认回滚：测试方法结束后事务自动回滚。
• 作用范围：
  • 类级别：所有测试方法共享事务。
  • 方法级别：仅当前方法生效。

---

2. @Rollback

作用

• 显式控制事务是否回滚：覆盖 @Transactional 的默认行为。
• 属性 value 取值：
  • true（默认）：回滚事务。
  • false：提交事务。

使用场景

• 需要手动提交事务以验证持久化效果。
• 调试时检查数据库实际状态。

示例代码

@Test  
@Transactional  
@Rollback(false) // 提交事务  
void testCommitTransaction() {  
    jdbcTemplate.update("INSERT INTO users (name) VALUES ('Bob')");  
    // 测试结束后，数据持久化到数据库  
}  

@Test  
@Transactional  
@Rollback // 等价于 @Rollback(true)  
void testDefaultRollback() {  
    // 默认回滚  
}  

---

3. @Commit

作用

• 提交事务：等价于 @Rollback(false)，语义更明确。

示例代码

@Test  
@Transactional  
@Commit // 提交事务  
void testCommitAnnotation() {  
    jdbcTemplate.update("INSERT INTO users (name) VALUES ('Charlie')");  
}  

---

4. @BeforeTransaction 与 @AfterTransaction

作用

• 事务边界扩展：在事务开始前（@BeforeTransaction）和结束后（@AfterTransaction）执行逻辑。
• 与 JUnit 生命周期的区别：
  • @BeforeEach/@AfterEach：在事务内执行。
  • @BeforeTransaction/@AfterTransaction：在事务外执行。

使用场景

• 准备事务外初始数据（如初始化只读数据）。
• 清理事务无法回滚的资源（如文件系统、外部 API 调用）。

示例代码

@ExtendWith(SpringExtension.class)  
@ContextConfiguration(classes = DataSourceConfig.class)  
public class TransactionHookTest {  
    @Autowired  
    private JdbcTemplate jdbcTemplate;  

    @BeforeTransaction  
    void beforeTransaction() {  
        // 在事务开始前插入初始数据（不受事务回滚影响）  
        jdbcTemplate.update("INSERT INTO config (key, value) VALUES ('mode', 'test')");  
    }  

    @AfterTransaction  
    void afterTransaction() {  
        // 在事务结束后清理数据（即使事务回滚也会执行）  
        jdbcTemplate.update("DELETE FROM config WHERE key = 'mode'");  
    }  

    @Test  
    @Transactional  
    void testInTransaction() {  
        // 此方法在事务内执行  
        jdbcTemplate.update("INSERT INTO users (name) VALUES ('Alice')");  
    }  
}  

---

5. 事务传播行为与隔离级别

高级配置

通过 @Transactional 的 propagation 和 isolation 属性控制事务行为。

示例代码

@Test  
@Transactional(  
    propagation = Propagation.REQUIRES_NEW,  // 始终开启新事务  
    isolation = Isolation.READ_COMMITTED      // 设置隔离级别  
)  
void testAdvancedTransaction() {  
    // 此方法在独立事务中运行  
}  

---

总结

注解	作用	默认行为
@Transactional	启用事务管理，支持类或方法级别。	方法结束回滚
@Rollback	显式控制事务提交/回滚。	true（回滚）
@Commit	提交事务，等价于 @Rollback(false)。	-
@BeforeTransaction	在事务开始前执行逻辑（事务外）。	-
@AfterTransaction	在事务结束后执行逻辑（事务外）。	-

最佳实践

1. 默认使用回滚：避免测试数据污染数据库。
2. 慎用 @Commit：仅在需要验证持久化时使用，并确保及时清理数据。
3. 利用钩子方法：@BeforeTransaction 和 @AfterTransaction 处理非事务资源。

通过合理使用事务注解，可确保测试的 独立性 和 可重复性，同时提升测试执行效率。