如何在Spring测试中覆盖spring.config.import配置？

问题根源在于@TestPropertySource默认是追加属性而非完全覆盖，导致原配置里的consul:依然存在，Spring Boot会同时尝试加载Consul和你指定的本地配置，Consul连接失败就抛出异常。以下是几种可靠的解决方法：

方法一：用@SpringBootTest的properties参数直接覆盖 #

@SpringBootTest的properties参数优先级高于application.yml，直接设置spring.config.import的值就能完全替换原配置，不会保留consul:项：

@SpringBootTest(properties = {"spring.config.import=classpath:/consul/defaults.yml"})
public class YourIntegrationTest {
    // 测试逻辑
}

如果想彻底禁用所有外部配置导入（仅用测试类内的属性），可以设置为：

@SpringBootTest(properties = {"spring.config.import=none"})

方法二：创建测试专用的配置文件 #

如果多个测试类需要共享这个配置，推荐在src/test/resources下创建application-test.yml，内容如下：

spring:
  config:
    import: classpath:/consul/defaults.yml

然后在测试类上启用test环境：

@SpringBootTest
@ActiveProfiles("test")
public class YourIntegrationTest {
    // 测试逻辑
}

Spring Boot会自动加载对应环境的配置文件，其优先级高于默认的application.yml，自然会覆盖spring.config.import的值。

方法三：正确使用@TestPropertySource #

如果坚持要用@TestPropertySource，确保直接赋值覆盖整个spring.config.import列表（注意不要用追加模式）：

@SpringBootTest
@TestPropertySource(properties = {"spring.config.import=classpath:/consul/defaults.yml"})
public class YourIntegrationTest {
    // 测试逻辑
}

这里的关键是直接赋值而非追加，Spring Boot会把该值作为完整的配置导入源列表，替换原有的consul:。

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