SpringBootTest中如何在ConfigDataLoader前Mock VaultTemplate Bean（禁用Bootstrap）

针对Spring Boot 2.4+使用spring.config.import加载Vault配置时的测试Mock需求，有几种无需启用bootstrap上下文的可行方案：

方案一：提前注册Mock Bean并标记@Primary #

在测试类中通过@TestConfiguration定义Mock的VaultTemplate，并使用@Primary确保它优先被Spring容器选用，这样VaultConfigDataLoader就不会再创建新的实例：

@SpringBootTest
@Import(VaultMockConfiguration.class)
public class YourServiceIntegrationTest {

    @TestConfiguration
    static class VaultMockConfiguration {
        @Bean
        @Primary
        public VaultTemplate vaultTemplate() {
            VaultTemplate mockTemplate = Mockito.mock(VaultTemplate.class);
            
            // 配置Mock行为，比如模拟读取Vault密钥的返回值
            VaultResponse mockResponse = new VaultResponse();
            mockResponse.setData(Map.of("db.password", "test-password"));
            when(mockTemplate.read("secret/db")).thenReturn(mockResponse);
            
            return mockTemplate;
        }
    }

    // 编写测试逻辑
    @Test
    void testServiceWithMockedVault() {
        // ...测试代码
    }
}

方案二：绕过Vault加载，直接使用本地测试配置 #

在测试专用的配置文件（如application-test.yml）中，将spring.config.import指向本地模拟的配置文件，完全跳过Vault的加载流程：

# application-test.yml
spring.config.import: optional:classpath:/mock-vault-secrets.yml

然后创建mock-vault-secrets.yml，写入测试需要的密钥数据：

# mock-vault-secrets.yml
db:
  password: test-password
api:
  key: test-api-key

这种方式适合不需要测试Vault交互逻辑，仅需验证业务逻辑的场景，配置更简洁。

方案三：自定义测试用ConfigDataLoader #

如果需要更细粒度的控制，可以实现一个测试专用的ConfigDataLoader，替换原有的VaultConfigDataLoader：

1. 编写Mock的ConfigDataLoader：

public class MockVaultConfigDataLoader implements ConfigDataLoader<VaultConfigDataResource> {

    @Override
    public ConfigData load(ConfigDataLoaderContext context, VaultConfigDataResource resource) throws IOException {
        // 构造模拟的配置数据
        Map<String, Object> mockData = Map.of(
            "db.password", "test-password",
            "api.key", "test-api-key"
        );
        return new ConfigData(Collections.singletonList(new SimpleConfigDataPropertySource(mockData)));
    }
}

2. 在测试模块的META-INF/spring.factories中注册该Loader：

org.springframework.boot.context.config.ConfigDataLoader=com.yourpackage.test.MockVaultConfigDataLoader

这样Spring Boot在加载配置时会优先使用这个Mock Loader，无需依赖真实的VaultTemplate。

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