Spring Boot测试中能否在测试类外自动注入local.server.port？

你的代码报错是因为SpecificControllerWrapper被标记为@Component，会被Spring主应用上下文扫描并实例化，但主上下文（非测试环境）中不存在local.server.port这个属性——@LocalServerPort本质是@Value("${local.server.port}")，因此会抛出占位符无法解析的错误。

方案一：将Wrapper类移至测试目录并使用@TestComponent #

这是最规范的做法，因为Wrapper是用于测试的工具类，不应被主应用上下文管理：

1. 把BaseControllerWrapper和SpecificControllerWrapper移动到src/test/java对应的包下
2. 将SpecificControllerWrapper上的@Component替换为@TestComponent（Spring Boot 2.2+支持），确保只有测试上下文会扫描并管理这个Bean，而测试环境因启用了RANDOM_PORT，local.server.port会被正确注入。

修改后代码示例：

// 位于src/test/java目录下
class BaseControllerWrapper {
    @LocalServerPort
    int port;
    // ... 其他逻辑
}

@TestComponent
class SpecificControllerWrapper extends BaseControllerWrapper {
    void callEndpoint() {
        // 示例：基于port调用接口
        String url = String.format("http://localhost:%d/your-endpoint", port);
        // ... 调用逻辑（如RestTemplate）
    }
}

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_EACH_TEST_METHOD)
public class PermissionsTest {

    @Autowired
    SpecificControllerWrapper specificControllerWrapper;

    @Test
    public void testSomething() {
        specificControllerWrapper.callEndpoint();
        // ... 断言逻辑
    }
}

方案二：在测试类中手动实例化Wrapper并注入端口 #

如果不想调整Wrapper的位置或注解，可以在测试类中手动创建实例，直接传入测试环境的随机端口：

// 主代码中的Wrapper保持不变，移除@Component注解
class BaseControllerWrapper {
    protected int port;

    public BaseControllerWrapper(int port) {
        this.port = port;
    }
    // ...
}

class SpecificControllerWrapper extends BaseControllerWrapper {
    public SpecificControllerWrapper(int port) {
        super(port);
    }

    void callEndpoint() {
        // ... 调用逻辑
    }
}

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_EACH_TEST_METHOD)
public class PermissionsTest {

    @LocalServerPort
    int port;

    private SpecificControllerWrapper specificControllerWrapper;

    @BeforeEach
    void setUp() {
        specificControllerWrapper = new SpecificControllerWrapper(port);
    }

    @Test
    public void testSomething() {
        specificControllerWrapper.callEndpoint();
        // ... 断言逻辑
    }
}

方案三：为主代码中的port设置默认值（仅应急用） #

如果Wrapper必须留在主代码中并被@Component管理，可以给port添加默认值，避免主应用启动时报错，但测试时仍会被随机端口覆盖：

class BaseControllerWrapper {
    @Value("${local.server.port:8080}") // 主环境默认8080，测试环境会替换为随机端口
    int port;
    // ...
}

@Component
class SpecificControllerWrapper extends BaseControllerWrapper {
    // ...
}

⚠️ 注意：这种方法可能导致主应用和测试环境的端口逻辑混淆，不推荐长期使用。

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