如何使用JUnit5实现Testcontainers镜像标签参数化测试

针对多数据库版本测试的需求，我们可以利用JUnit5的@TestInstance(Lifecycle.PER_CLASS)特性，结合参数化测试实现同一参数下所有测试方法共用一个仅启动一次的容器，避免重复启动容器，同时保持代码优雅。

完整示例代码（多数据库版本测试） #

import org.junit.jupiter.api.TestInstance;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;
import org.testcontainers.containers.MySQLContainer;
import static org.junit.jupiter.api.Assertions.*;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class ParameterizedDatabaseContainerTest {

    private final String expectedVersion;
    private final MySQLContainer<?> mysqlContainer;

    // 构造方法接收参数，初始化对应版本的容器
    public ParameterizedDatabaseContainerTest(String imageName, String expectedVersion) {
        this.expectedVersion = expectedVersion;
        this.mysqlContainer = new MySQLContainer<>(imageName)
                .withDatabaseName("testdb")
                .withUsername("testuser")
                .withPassword("testpass");
        mysqlContainer.start();
    }

    // 提供多组数据库镜像参数
    static Object[][] databaseVersions() {
        return new Object[][]{
                {"mysql:5.7", "5.7"},
                {"mysql:8.0", "8.0"},
                {"mariadb:10.6", "10.6"}
        };
    }

    @ParameterizedTest(name = "验证[{0}]容器运行状态与版本")
    @MethodSource("databaseVersions")
    void testContainerAndVersion(String imageName, String expectedVersion) {
        // 验证容器处于运行状态
        assertTrue(mysqlContainer.isRunning());
        
        // 验证数据库版本匹配
        String dbVersionOutput = mysqlContainer.execInContainer("mysql", "-V").getStdout().trim();
        assertTrue(dbVersionOutput.contains(this.expectedVersion), 
                   "数据库版本应包含预期值: " + this.expectedVersion);
    }

    @ParameterizedTest(name = "验证[{0}]数据库 schema 创建能力")
    @MethodSource("databaseVersions")
    void testSchemaCreation(String imageName, String expectedVersion) {
        // 复用已启动的容器，执行数据库操作
        try (var connection = mysqlContainer.createConnection("")) {
            var statement = connection.createStatement();
            statement.execute("CREATE TABLE test_table (id INT PRIMARY KEY)");
            
            // 验证表已创建
            var resultSet = statement.executeQuery("SHOW TABLES LIKE 'test_table'");
            assertTrue(resultSet.next(), "测试表应成功创建");
        } catch (Exception e) {
            fail("Schema 创建失败", e);
        }
    }
}

核心实现要点 #

• @TestInstance(TestInstance.Lifecycle.PER_CLASS)：将测试实例生命周期改为每个参数对应一个实例（默认是每个测试方法一个实例），保证同一参数下的所有测试方法复用同一个容器实例。
• 构造方法初始化容器：每个参数（数据库镜像+预期版本）传入构造方法，初始化对应版本的容器并启动，确保每个参数对应唯一的容器实例，且仅启动一次。
• 参数化测试绑定：通过@ParameterizedTest和@MethodSource提供多组测试参数，每组参数会触发所有测试方法执行，但共用同一个已启动的容器。
• 容器复用逻辑：因为每个参数对应独立的测试实例，容器作为实例变量，同一参数的所有测试方法无需重复启动容器，直接使用已运行的容器资源。

优势 #

• 避免了if/else、TestInfo等繁琐的分支判断，代码结构清晰
• 同一版本的数据库容器仅启动一次，大幅提升测试执行效率
• 完全贴合JUnit5的注解式测试规范，符合现代Java测试最佳实践

内容的提问来源于stack exchange，提问作者Christophe Willemsen