在 java 单元测试中使用 testcontainers 启动 mysql 容器,核心做法是引入 testcontainers 依赖并配合 junit 5 的 @container 注解。通过实例化 mysqlcontainer 对象,testcontainers 会自动拉取镜像、启动容器并暴露端口,测试类中只需配置数据源指向该容器的 jdbc url 即可。

如何配置 JUnit 5 环境以自动管理容器生命周期
配置的关键在于使用 @Container 注解声明容器实例,并利用 @DynamicPropertySource 将容器属性注入到 Spring 或应用配置中。这样无需手动处理容器的启动与关闭,JVM 退出时容器会自动销毁。

import org.testcontainers.containers.MySQLContainer;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.RegisterExtension;
public class MySQLIntegrationTest {
@Container
static MySQLContainer<?> mysql = new MySQLContainer("mysql:8.0")
.withDatabaseName("testdb")
.withUsername("root")
.withPassword("password");
// 动态注入配置
@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
registry.add("spring.datasource.url", mysql::getJdbcUrl);
registry.add("spring.datasource.username", mysql::getUsername);
registry.add("spring.datasource.password", mysql::getPassword);
}
@Test
public void testConnection() {
// 此时 Spring 已连接至容器中的 MySQL
}
}
如何处理数据库 Schema 初始化与数据清理
处理 Schema 初始化的标准做法是利用 MySQLContainer 提供的 withInitScript() 方法加载 SQL 文件,或在代码中调用 Flyway/Liquibase。关于数据清理,由于每次测试运行都会重启一个新的容器实例(除非复用),因此天然实现了环境隔离,无需手动清理数据。
立即学习“Java免费学习笔记(深入)”;

// 使用 withInitScript 初始化表结构
static MySQLContainer<?> mysql = new MySQLContainer("mysql:8.0")
.withDatabaseName("testdb")
.withInitScript("schema.sql"); // 位于 classpath 下
当容器启动失败或端口冲突时程序会返回什么异常
当容器启动失败(如 Docker 守护进程未运行)或端口被占用时,程序会抛出 IllegalStateException 或 DockerClientException。具体表现为 waitUntilContainerStarted 超时或绑定本地端口失败,导致测试类加载阶段直接中断。


















