Spring Boot 中动态注入外部密码属性的正确实践

在 spring boot 启动早期阶段，需从外部系统（如密钥管理服务）获取敏感配置（如数据库密码），并确保其在第三方 bean 初始化前生效；`system.setproperty()` 无效，应使用 `environmentpostprocessor` 在环境准备阶段注入属性。

Spring Boot 的属性解析机制遵循严格的生命周期顺序：@Value("${...}") 占位符的解析发生在 Bean 实例化之前，但依赖于 Environment 中已注册的 PropertySource。而 System.setProperty() 设置的 JVM 系统属性虽可被 Spring 默认识别（因 SystemEnvironmentPropertySource 通常已存在），但其加载时机早于 @PostConstruct —— 换言之，当 MyConfiguration#init() 执行时，EncryptionBean 很可能已被 Spring 容器完成实例化与依赖注入，导致 @Value 仍取默认值 DEFAULT。

根本原因在于：Spring 容器在刷新（refresh()）阶段早期即完成所有 @Configuration 类解析、@Bean 方法执行及依赖注入，而 @PostConstruct 是单个 Bean 初始化后的回调，此时全局属性已冻结。因此，任何在 @PostConstruct 中修改系统属性或环境变量的操作，对已启动的占位符解析流程均无影响。

✅ 正确解法：使用 EnvironmentPostProcessor

该接口允许你在 Spring Boot 应用上下文创建前、Environment 尚未冻结时，动态注入自定义属性源。它执行时机远早于任何 @Bean 创建，完美匹配“先设值、后注入”的需求。

以下为完整实现示例：

public class PasswordEnvironmentPostProcessor implements EnvironmentPostProcessor, ApplicationContextAware {

    private ApplicationContext applicationContext;

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        // 注意：此时 ApplicationContext 尚未完全初始化，但已可获取已注册的 Bean（如 SDKObject）
        // 若 SDKObject 本身依赖其他 Bean，建议确保其声明为 static 或使用 SmartInitializingSingleton 延迟初始化
        try {
            SDKObject sdkObject = applicationContext.getBean(SDKObject.class);
            String password = sdkObject.retrievePassword();
            if (password == null || password.trim().isEmpty()) {
                throw new IllegalStateException("Failed to retrieve non-empty password from SDK");
            }

            Map properties = Map.of("my.password", password);
            PropertySource propertySource = new MapPropertySource("external-password", properties);
            environment.getPropertySources().addFirst(propertySource);
        } catch (NoSuchBeanDefinitionException e) {
            throw new IllegalStateException("SDKObject bean not available during EnvironmentPostProcessor execution", e);
        }
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }
}

? 关键注意事项：

• EnvironmentPostProcessor 必须通过 META-INF/spring.factories 显式注册，否则不会被 Spring Boot 自动发现：

  # src/main/resources/META-INF/spring.factories
  org.springframework.boot.env.EnvironmentPostProcessor=com.example.PasswordEnvironmentPostProcessor

• 不要尝试在 postProcessEnvironment 中调用 applicationContext.getBean() 获取尚未初始化的 Bean（如 @Lazy 或作用域为 prototype 的 Bean）。SDKObject 应为 singleton 且不依赖后期初始化逻辑。
• 若 SDKObject 初始化本身也需外部配置，建议将其封装为 @Bean 并配合 @ConditionalOnMissingBean，确保其在 EnvironmentPostProcessor 执行前就绪。
• 属性源添加顺序很重要：addFirst() 确保你的密码属性优先级高于 application.properties 和系统属性，避免被覆盖。

? 补充替代方案（仅作参考，不推荐）：

• 使用 ApplicationContextInitializer：功能类似，但需在 SpringApplication 构造时手动注册（如 springApplication.addInitializers(...)），侵入主类启动逻辑，不利于模块复用。
• 自定义 PropertySourcesPlaceholderConfigurer：复杂度高、易出错，且 Spring Boot 2.4+ 已弃用传统方式，统一由 Environment 管理。

综上，EnvironmentPostProcessor 是 Spring Boot 官方推荐、语义清晰、时机精准的标准扩展点，专为解决此类“启动期动态配置注入”问题而设计。务必避免在生命周期后期（如 @PostConstruct、@EventListener(ApplicationReadyEvent.class)）尝试修补环境，那已为时已晚。