如何阻止Spring Cloud重绑定@ConfigurationProperties POJO及测试端口注入？

针对你遇到的两个核心问题——阻止Spring Cloud触发的@ConfigurationProperties重绑定，以及测试环境下动态端口的注入，我给你整理了具体的解决方案：

一、阻止特定@ConfigurationProperties类的重绑定 #

Spring Cloud的EnvironmentChangeEvent触发时，会通过ConfigurationPropertiesRebinder重新绑定所有标注了@ConfigurationProperties的类。要阻止特定类被重绑定，有两种简单可行的方式：

1. 通过配置排除目标类 #

在你的测试环境配置文件（比如application-test.yml）中添加以下配置，指定要排除重绑定的类全限定名：

spring:
  cloud:
    refresh:
      exclude: com.yourpackage.YourPropertiesClass

这样当EnvironmentChangeEvent触发时，这个类就不会被重新绑定，你手动修改的属性值也不会被覆盖。

2. 全局禁用Spring Cloud刷新功能（测试场景推荐） #

如果只是在测试环境下不需要属性刷新，可以直接在测试类上通过@TestPropertySource全局禁用：

@SpringBootTest
@TestPropertySource(properties = "spring.cloud.refresh.enabled=false")
public class YourTestClass {
    // ...
}

这种方式简单直接，适合测试环境下完全不需要属性自动刷新的场景。

二、测试场景下动态端口注入的最优方案 #

你提到尝试了System.setProperty()、添加PropertySource等方法都没成功，大概率是因为Spring Cloud的重绑定覆盖了你的设置，或者属性源优先级不够。针对测试环境动态生成端口的场景，推荐以下两种更可靠的方案：

1. 使用@DynamicPropertySource（Spring Boot 2.2+） #

这是Spring Boot官方推荐的动态注入测试属性的方式，属性优先级极高，且会被@ConfigurationProperties正确读取，即使Spring Cloud开启了重绑定，也会优先使用这个属性值。

假设你的动态端口是由某个测试库生成的，示例代码如下：

@SpringBootTest
public class YourServiceTest {
    // 假设这是生成动态端口的对象（比如Testcontainers容器、自定义端口生成器）
    private final DynamicPortGenerator portGenerator = new DynamicPortGenerator();

    @DynamicPropertySource
    static void registerDynamicProperties(DynamicPropertyRegistry registry) {
        // 替换成你获取动态端口的逻辑
        int dynamicPort = portGenerator.getGeneratedPort();
        registry.add("my.port", () -> dynamicPort);
    }

    @Autowired
    private YourProperties properties;

    @Test
    public void testPortBinding() {
        // 验证属性是否正确注入
        Assertions.assertEquals(portGenerator.getGeneratedPort(), properties.getPort());
    }
}

@DynamicPropertySource会在Spring上下文启动阶段就把属性注入到环境中，优先级高于大多数属性源，完全不用担心被覆盖。

2. 关闭重绑定后直接修改POJO字段 #

如果必须在@Before方法中设置端口，可以结合前面的“关闭重绑定”方案，直接修改@ConfigurationProperties类的字段值：

@SpringBootTest
@TestPropertySource(properties = "spring.cloud.refresh.enabled=false")
public class YourTestClass {
    @Autowired
    private YourProperties yourProperties;

    @Before
    public void setup() {
        // 获取动态生成的端口
        int dynamicPort = getDynamicPortFromLibrary();
        // 直接设置POJO的端口属性
        yourProperties.setPort(dynamicPort);
    }

    // ... 测试方法
}

因为已经禁用了重绑定，所以这里设置的值不会被后续的EnvironmentChangeEvent覆盖，被测应用会正确使用这个端口。

为什么你之前的尝试没成功？ #

你用System.setProperty()或添加PropertySource失败，主要是因为：

• Spring Cloud的重绑定会重新读取原始属性源（比如yml文件）的值，覆盖你后续添加的属性；
• 部分属性源的优先级低于默认的配置文件，导致你的设置被覆盖。
  而上面的方案要么提高了属性优先级，要么直接禁用了重绑定，完美解决了这个问题。

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