SpringBoot测试中RestClient无法访问自身端点问题排查

一、关于测试时端口是否暴露的问题 #

Spring Boot测试默认采用MOCK环境，不会启动真实服务器，必须显式指定webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT才会启动真实服务器并分配随机端口。同时要确保正确获取实际端口：

使用@LocalServerPort注解直接注入端口，避免手动拼接或硬编码错误：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class ActuatorRestClientTest {

    @LocalServerPort
    private int serverPort;

    private RestClient restClient;

    @BeforeEach
    void initRestClient() {
        restClient = RestClient.create("http://localhost:" + serverPort);
    }

    @Test
    void testActuatorHealth() {
        String healthResponse = restClient.get()
                .uri("/actuator/health")
                .retrieve()
                .body(String.class);
        // 自定义断言逻辑
    }
}

如果未添加webEnvironment = RANDOM_PORT，测试会使用MockMvc环境，无真实端口可用，必然抛出连接异常。

二、可能遗漏的配置项 #

1. 测试环境的Actuator端点暴露配置 #

Spring Boot默认在测试环境下不会暴露所有Actuator端点，需在application-test.properties中显式配置：

# 暴露所有web端点
management.endpoints.web.exposure.include=*
# 可选：允许显示health端点的详细信息
management.endpoint.health.show-details=always

若未配置该项，即使服务器启动，Actuator端点也会被隐藏，导致无法访问。

2. 排查ResourceAccessException的具体原因 #

该异常是底层连接问题的包装类，建议打印完整栈信息定位根因：

try {
    restClient.get().uri("/actuator").retrieve().toBodilessEntity();
} catch (ResourceAccessException e) {
    e.printStackTrace(); // 或用日志框架打印完整异常栈
}

• 若为连接拒绝：大概率是端口获取错误，或未启用真实服务器环境
• 若为超时：测试环境服务器启动较慢，可在application-test.properties中增加超时配置：

spring.lifecycle.timeout-per-shutdown-phase=30s
spring.test.context.startup.timeout=30s

3. Testcontainers的潜在干扰 #

如果测试集成了Testcontainers，需确保未修改Spring Boot服务器端口配置，或容器网络未隔离本地服务器。由于是调用自身应用端点，该场景影响较小，但如果自定义了Testcontainers网络配置，需检查是否允许本地访问。

总结 #

• 端口未暴露的核心原因：未指定webEnvironment = RANDOM_PORT导致使用Mock环境，或端口获取错误
• 遗漏的常见配置：测试环境的Actuator端点暴露配置、RestClient的baseUrl绑定错误、服务器启动超时配置

内容的提问来源于stack exchange，提问作者d.braun1991