基于Spring Profile控制TestContainers启停的实现方案咨询

方案1：单基类静态块判断Profile启动容器 #

直接在统一的基类里通过静态逻辑判断当前激活的Profile，仅在local环境启动DockerComposeContainer，测试类只需要继承这一个基类即可。

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.TestPropertySource;
import org.testcontainers.containers.DockerComposeContainer;
import org.testcontainers.junit.jupiter.Testcontainers;
import java.io.File;

@SpringBootTest
@Testcontainers
@TestPropertySource(locations = "classpath:application-test.properties")
public abstract class BaseIntegrationTest {

    // 静态容器实例，复用避免重复启动
    private static DockerComposeContainer<?> dockerComposeContainer;

    static {
        // 获取激活的Profile，默认local
        String activeProfile = System.getProperty("spring.profiles.active", "local");
        if ("local".equals(activeProfile)) {
            // 初始化并启动容器
            dockerComposeContainer = new DockerComposeContainer<>(new File("docker-compose-test.yml"))
                    .withExposedService("mysql", 3306)
                    .withExposedService("redis", 6379);
            dockerComposeContainer.start();

            // 将容器映射的端口注入系统属性，供测试配置文件使用
            System.setProperty("spring.datasource.url",
                "jdbc:mysql://localhost:" + dockerComposeContainer.getServicePort("mysql", 3306) + "/testdb");
            System.setProperty("spring.redis.port",
                String.valueOf(dockerComposeContainer.getServicePort("redis", 6379)));
        }
    }
}

测试类只需继承这个基类，无需关心环境：

public class UserServiceTest extends BaseIntegrationTest {
    // 测试逻辑
}

方案2：Spring条件化Bean（更优雅的Spring风格） #

利用Spring的条件注解，将容器定义为一个Bean，仅在local Profile下创建并启动。这种方式更贴合Spring的依赖注入模型，代码解耦性更好。

第一步：创建容器配置类

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.core.env.Profiles;
import org.testcontainers.containers.DockerComposeContainer;
import java.io.File;

@Configuration
public class TestContainerConfig {

    @Bean
    // 仅当激活local Profile时创建该Bean
    @Conditional(LocalProfileCondition.class)
    public DockerComposeContainer<?> dockerComposeContainer() {
        DockerComposeContainer<?> container = new DockerComposeContainer<>(new File("docker-compose-test.yml"))
                .withExposedService("mysql", 3306)
                .withExposedService("redis", 6379);
        container.start();

        // 设置系统属性供配置文件读取
        System.setProperty("mysql.port", String.valueOf(container.getServicePort("mysql", 3306)));
        System.setProperty("redis.port", String.valueOf(container.getServicePort("redis", 6379)));
        return container;
    }

    // 自定义条件判断类
    static class LocalProfileCondition implements Condition {
        @Override
        public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
            Environment env = context.getEnvironment();
            return env.acceptsProfiles(Profiles.of("local"));
        }
    }
}

第二步：简化基类

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.Import;
import org.springframework.test.context.TestPropertySource;
import org.testcontainers.junit.jupiter.Testcontainers;

@SpringBootTest
@Testcontainers
@TestPropertySource(locations = "classpath:application-test.properties")
@Import(TestContainerConfig.class) // 引入容器配置
public abstract class BaseIntegrationTest {
    // 无需额外逻辑，所有测试类继承即可
}

关键注意事项 #

• Profile设置：测试时通过JVM参数-Dspring.profiles.active=local，或在测试类上加@ActiveProfiles("local")指定环境。
• 配置文件占位符：建议在application-test.properties中用占位符读取容器端口，比如：

  spring.datasource.url=jdbc:mysql://localhost:${mysql.port}/testdb
  spring.redis.port=${redis.port}
  

• 容器复用：在src/test/resources/testcontainers.properties中添加testcontainers.reuse.enable=true，避免每次测试重启容器，提升执行速度。

内容的提问来源于stack exchange，提问作者dhasan k