如何基于Testcontainers打包部署Spring Boot应用实例用于测试

完全可行。Testcontainers原生支持加载任意本地/远程仓库的已构建Docker镜像，天然适配多容器互联场景，完全满足在测试流程中部署多套互联Spring Boot微服务的需求，不需要对现有已构建的镜像做任何改造。

测试环境只需要满足两个基础条件即可：

• 运行测试的机器可以正常连接可用的Docker daemon（本地Docker Desktop、远程Docker实例都支持）
• 测试模块已经引入Testcontainers核心依赖，Spring Boot+JUnit 5场景下只需要引入org.testcontainers:testcontainers和org.testcontainers:junit-jupiter两个核心包，不需要额外的特殊适配包。

1. 创建共享容器网络 #

多个微服务要实现内部互通，必须把所有服务容器挂载到同一个自定义Testcontainers网络上，避免默认桥接网络的隔离限制：

// 所有微服务容器共用该网络实例
static final Network SERVICE_NETWORK = Network.newNetwork();

2. 定义各微服务容器实例 #

针对每个已经构建完成的Spring Boot镜像，通过GenericContainer类定义容器配置，指定镜像地址、暴露端口、网络别名、环境变量、服务就绪检测规则即可。

注意：网络别名是容器在内部共享网络中的固定访问域名，微服务之间互相调用时直接使用「网络别名+服务内部监听端口」即可，不需要做额外的端口映射，也不会出现宿主机端口冲突问题。

以下为双微服务配置示例，假设存在预构建的用户服务镜像my-project/user-service:1.0.0、订单服务镜像my-project/order-service:1.0.0：

// 定义用户服务容器
static final GenericContainer<?> USER_SERVICE = new GenericContainer<>(DockerImageName.parse("my-project/user-service:1.0.0"))
        .withExposedPorts(8080) // 服务内部的监听端口
        .withNetwork(SERVICE_NETWORK)
        .withNetworkAliases("user-service") // 内部网络访问别名
        .withEnv("SPRING_PROFILES_ACTIVE", "test") // 按需传入环境变量、配置参数覆盖应用配置
        // 等待服务完全就绪再执行测试，有actuator可以用健康检查接口，没有的话换成Wait.forListeningPort()即可
        .waitingFor(Wait.forHttp("/actuator/health").forStatusCode(200));

// 定义订单服务容器
static final GenericContainer<?> ORDER_SERVICE = new GenericContainer<>(DockerImageName.parse("my-project/order-service:1.0.0"))
        .withExposedPorts(8080)
        .withNetwork(SERVICE_NETWORK)
        .withNetworkAliases("order-service")
        .withEnv("SPRING_PROFILES_ACTIVE", "test")
        // 服务间调用地址直接用网络别名配置即可，不需要关心宿主机映射端口
        .withEnv("USER_SERVICE_ENDPOINT", "http://user-service:8080")
        .waitingFor(Wait.forHttp("/actuator/health").forStatusCode(200));

3. 绑定容器生命周期 #

搭配JUnit 5的@Testcontainers注解即可自动管理容器启停，不需要手动写启动/销毁逻辑：

• 用static修饰的容器会在整个测试类的所有用例执行前启动，全部用例跑完后自动销毁，适合多服务启动耗时长、需要复用实例的场景
• 不用static修饰的容器会在每个测试方法执行前重新创建启动，方法执行完立即销毁，适合需要完全隔离干净环境的测试场景

示例测试类结构：

@Testcontainers
@SpringBootTest
class MultiServiceIntegrationTest {
    static final Network SERVICE_NETWORK = Network.newNetwork();

    @Container
    static final GenericContainer<?> USER_SERVICE = // 复用上述用户服务定义

    @Container
    static final GenericContainer<?> ORDER_SERVICE = // 复用上述订单服务定义

    // 测试用例直接写在这里，所有服务就绪后才会开始执行用例逻辑
}

4. 测试侧访问配置 #

如果测试代码本身需要调用容器内的微服务接口，不要写死端口，通过容器实例提供的方法获取实际映射的宿主机访问地址：

// 获取用户服务对外的访问地址
String userServiceAccessUrl = String.format("http://%s:%d",
        USER_SERVICE.getHost(),
        USER_SERVICE.getMappedPort(8080));

• 不需要提前把微服务镜像推送到公共远程仓库，只要镜像存在于Testcontainers所连接的Docker daemon的本地镜像列表中，就可以直接加载使用
• 微服务之间的内部调用不要走宿主机映射端口，直接使用网络别名+内部端口，通信走Docker内部网络，不会有端口冲突问题
• 如果微服务还依赖数据库、MQ、Redis等中间件，直接把对应的Testcontainers中间件容器也加入同一个共享网络即可，用法和普通单服务集成测试完全一致

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