如何为Spring Boot集成测试配置外部Mock的随机端口？

不用手动启动Spring Boot应用，Spring Boot Test提供了动态配置属性的机制，可以在Testcontainers启动后把端口自动注入到应用配置里，完美解决静态配置的限制。

实现步骤 #

• 先启动Testcontainers容器（确保在Spring上下文初始化前完成）
• 用@DynamicPropertySource动态向Spring环境注入外部服务的配置属性
• 正常使用@SpringBootTest启动应用，它会自动读取动态注入的配置

完整代码示例 #

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.client.TestRestTemplate;
import org.springframework.test.context.DynamicPropertySource;
import org.testcontainers.containers.GenericContainer;
import org.testcontainers.junit.jupiter.Testcontainers;

import static org.junit.jupiter.api.Assertions.assertTrue;

@Testcontainers
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class IntegrationTest {

    // 静态容器实例，保证Spring启动前先启动外部Mock
    private static GenericContainer<?> externalMock;

    @Autowired
    private TestRestTemplate restTemplate;

    @BeforeAll
    static void initializeExternalMocks() {
        // 替换成你的Mock服务镜像和内部端口
        externalMock = new GenericContainer<>("your-mock-image:latest")
                .withExposedPorts(8080);
        externalMock.start();
    }

    @DynamicPropertySource
    static void configureExternalServiceProperties(DynamicPropertyRegistry registry) {
        // 把容器的随机映射端口注入到Spring配置中，对应你应用里的配置键
        registry.add("external.service.url", () -> 
                String.format("http://localhost:%d", externalMock.getMappedPort(8080)));
    }

    @Test
    void shouldCallExternalService() {
        // 调用Spring Boot应用接口
        restTemplate.getForObject("/my-spring-boot-app/request", String.class);

        // 验证Mock服务是否收到请求（根据你的Mock实现调整逻辑）
        boolean requestReceived = checkMockRequestReceived();
        assertTrue(requestReceived);
    }

    // 示例验证逻辑：调用Mock的管理接口检查请求记录
    private boolean checkMockRequestReceived() {
        String verifyResult = restTemplate.getForObject(
                String.format("http://localhost:%d/verify-request", externalMock.getMappedPort(8080)),
                String.class);
        return "received".equals(verifyResult);
    }
}

关键细节说明 #

• @DynamicPropertySource：这是核心，它允许在Spring上下文启动前动态添加配置属性，彻底解决@SpringBootTest静态配置的局限
• externalMock.getMappedPort(8080)：获取容器映射到宿主机的随机端口，自动替换应用配置里的固定端口
• 如果用的是专用Mock服务（比如WireMock），可以直接用Testcontainers提供的专用容器模块，代码会更简洁：

  private static WireMockContainer wireMockContainer = new WireMockContainer("wiremock/wiremock:3.3.1")
          .withMappingFromResource("mappings/your-request-mapping.json");
  
  @DynamicPropertySource
  static void configureWireMock(DynamicPropertyRegistry registry) {
      registry.add("external.service.url", wireMockContainer::getBaseUrl);
  }
  

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