单元测试中覆盖Spring @Value注解的默认值

这确实是个容易踩的坑——当@Value带有默认值时，很多人会疑惑为什么@TestPropertySource的配置没生效，其实核心原因是Spring会优先使用环境中存在的同名属性，只有当环境中没有该属性时才会 fallback 到默认值。你的测试中没生效，大概率是配置方式的小问题，下面给你几种可行的解决方案：

方案一：直接用@TestPropertySource的properties参数硬编码属性 #

这是最简单的方式，适合只需要覆盖少量属性的场景。直接在测试类上指定要覆盖的键值对：

@SpringBootTest // 或者@ContextConfiguration，根据你的测试类型选择
@TestPropertySource(properties = {"MAX_CONN=2"})
public class ConnectionConfigTest {
    // 你的测试逻辑
}

这样Spring测试上下文启动时，会把MAX_CONN=2注入到环境中，@Value("${MAX_CONN:200}")就会优先取到2，而不是默认的200。

方案二：使用测试专用的配置文件 #

如果需要覆盖多个属性，或者想把配置集中管理，可以在src/test/resources下创建一个测试专用的配置文件（比如application-test.properties），然后在测试类中指定加载它：

1. 创建src/test/resources/application-test.properties：

MAX_CONN=2
# 其他需要覆盖的属性也可以写在这里

2. 在测试类中指定加载这个文件：

@SpringBootTest
@TestPropertySource(locations = "classpath:application-test.properties")
public class ConnectionConfigTest {
    // 你的测试逻辑
}

方案三：用@DynamicPropertySource动态注册属性（Spring Boot 2.2+推荐） #

如果需要更灵活的属性设置（比如动态生成值，或者确保最高优先级覆盖），可以使用@DynamicPropertySource注解，它的优先级比@TestPropertySource更高，能确保覆盖任何默认值：

@SpringBootTest
public class ConnectionConfigTest {

    @DynamicPropertySource
    static void setupTestProperties(DynamicPropertyRegistry registry) {
        // 直接注册属性值，这里可以写动态逻辑，比如从变量、方法返回值获取
        registry.add("MAX_CONN", () -> 2);
    }

    // 你的测试逻辑
}

几个需要注意的坑 #

• 属性名大小写敏感：Spring默认对属性名大小写敏感，确保你测试中设置的属性名和@Value里的完全一致（比如@Value里是${MAX_CONN:200}，测试里就不能写成max_conn=2，除非你配置了relaxed binding）。
• 确保上下文正确加载：测试类必须加载Spring上下文，比如添加@SpringBootTest或者@ContextConfiguration注解，否则@TestPropertySource不会生效。
• 环境变量的优先级：如果你的系统环境中已经设置了MAX_CONN，它的优先级会比@TestPropertySource高，这时候需要确保测试环境隔离（比如用@DynamicPropertySource覆盖，或者在测试前清空环境变量）。

只要确保测试环境中存在同名的属性，@Value的默认值就会被成功覆盖，你可以根据自己的场景选择上面的任意一种方法。

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