Spring Boot集成测试端口冲突：RANDOM_PORT未生效求助

我正在为自身开发的、运行在8888端口的微服务编写Spring Boot集成测试。测试类代码如下：

import com.mydomain.app.MyAPI; 
import org.junit.Test; 
import org.junit.runner.RunWith; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.test.context.SpringBootTest; 
import org.springframework.boot.test.context.SpringBootTest.WebEnvironment; 
import org.springframework.boot.test.web.client.TestRestTemplate; 
import org.springframework.test.context.junit4.SpringRunner; 
import org.springframework.http.HttpHeaders; 
import org.springframework.http.HttpEntity; 
import org.springframework.http.ResponseEntity; 

@RunWith(SpringRunner.class) 
@SpringBootTest(classes = {MyAPI.class}, webEnvironment = WebEnvironment.RANDOM_PORT) 
public class MyIntegrationTest { 
    @Autowired 
    private TestRestTemplate testRestTemplate; 

    @Test 
    public void contextLoads() { } 
} 

未启动微服务时，测试可正常通过（上下文加载成功）；但启动微服务后运行测试，会出现端口8888已被占用的错误。我知晓该端口被正在运行的微服务占用，但不理解为何设置WebEnvironment=RANDOM_PORT后，测试服务器仍未分配其他端口，恳请协助解决。

这个问题的核心是你设置的RANDOM_PORT被应用的固定端口配置覆盖了，下面给你拆解原因和解决办法：

为什么会出现这个问题？ #

WebEnvironment.RANDOM_PORT的作用是告诉Spring Boot："启动嵌入式服务器时请分配一个随机可用端口"，但如果你的微服务已经通过配置文件、硬编码或者环境变量固定了server.port=8888，这个配置的优先级会高于RANDOM_PORT的设置，导致测试上下文还是试图使用8888端口，和正在运行的服务冲突。

具体解决办法 #

1. 直接在测试注解中覆盖端口配置

最简单的方式是通过@SpringBootTest的properties属性，强制指定测试用的端口为0（Spring Boot会自动分配随机可用端口）：

@RunWith(SpringRunner.class)
@SpringBootTest(
    classes = {MyAPI.class}, 
    webEnvironment = WebEnvironment.RANDOM_PORT,
    properties = {"server.port=0"} // 关键：强制用随机端口
)
public class MyIntegrationTest {
    // ... 你的测试代码
}

2. 为测试创建专属配置文件

如果你的测试需要更多自定义配置，可以在src/test/resources下创建application-test.properties（或yml），添加：

server.port=0

然后在测试类上激活这个测试配置文件：

@RunWith(SpringRunner.class)
@SpringBootTest(
    classes = {MyAPI.class}, 
    webEnvironment = WebEnvironment.RANDOM_PORT
)
@ActiveProfiles("test") // 激活测试配置
public class MyIntegrationTest {
    // ... 你的测试代码
}

3. 排查硬编码的端口设置

检查你的应用代码中是否有硬编码端口的逻辑（比如自定义的TomcatServletWebServerFactory配置类），如果有，需要确保测试时能覆盖这个配置，比如通过@TestConfiguration在测试中重新定义相关Bean，或者让配置读取外部参数而非固定值。

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