Spring Boot 3测试后@DirtiesContext清理MySQL8数据库失效问题排查

你用@DirtiesContext来清理数据库数据是方向错误——这个注解的作用是销毁并重建Spring应用上下文，比如当测试修改了上下文内单例Bean的状态，需要重置上下文时才适合使用。它完全不会处理外部数据库这类资源，所以你的测试数据会留在MySQL里，这就是它“不起作用”的原因。

适合你的无代码注解方案 #

方案1：用@Sql注解执行清理脚本 #

这是最直接的方式，通过注解指定测试前准备数据、测试后清理数据的SQL脚本，不需要编写Java代码。

修改你的测试方法注解：

@Test
@Sql(scripts = "/create_suppliers.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
@Sql(scripts = "/clean_test_data.sql", executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)
@DisplayName("Happy path: Create articles")
void WHEN_calling_create_articles_THEN_status_is_200() {
    // 现有测试代码不变
}

然后在src/test/resources下创建clean_test_data.sql脚本，根据你的表结构清理数据（注意处理外键约束）：

-- 临时关闭外键检查，避免删除时出错
SET FOREIGN_KEY_CHECKS = 0;
-- 清理测试生成的文章数据
TRUNCATE TABLE article;
-- 如果需要清理供应商测试数据，也加上
TRUNCATE TABLE supplier;
-- 恢复外键检查
SET FOREIGN_KEY_CHECKS = 1;

方案2：改用嵌入式数据库自动重置 #

如果你的集成测试可以用嵌入式数据库（比如H2）替代真实MySQL，Spring Boot会自动在每次测试后重置数据库，完全不需要额外代码。

修改测试类注解：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.ANY)
@DisplayName("Articles Integration Tests")
public class ArticlesControllerIT {
    // 现有代码不变
}

这种方式的优势是完全不用管数据清理，但缺点是和生产环境的MySQL存在差异，适合不需要严格匹配生产数据库的场景。

方案3：用Testcontainers管理MySQL容器 #

如果必须用真实MySQL，可以用Testcontainers注解式启动独立的MySQL容器，每个测试后自动销毁容器，数据自然清空。

添加Testcontainers依赖（Maven为例）：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>mysql</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>

修改测试类：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@Testcontainers
@DisplayName("Articles Integration Tests")
public class ArticlesControllerIT {

    @Container
    static MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:8.0")
            .withDatabaseName("testdb")
            .withUsername("test")
            .withPassword("test");

    @DynamicPropertySource
    static void configureProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", mysqlContainer::getJdbcUrl);
        registry.add("spring.datasource.username", mysqlContainer::getUsername);
        registry.add("spring.datasource.password", mysqlContainer::getPassword);
    }

    // 现有注入和测试代码不变
}

这种方式既用了真实MySQL，又能自动清理数据，但需要额外依赖，测试启动速度会稍慢。

总结 #

• @DirtiesContext不适合你的数据库清理需求，它的作用是重置Spring上下文，和数据库无关。
• 优先推荐方案1（@Sql脚本），如果允许用嵌入式数据库选方案2，必须用真实MySQL选方案3。

内容的提问来源于stack exchange，提问作者Ulises CT