在 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 创建，完美匹配“先设值、后注入”的需求。
当用户希望自动格式化、排版或美化 Word（`.docx`）文档时，应使用此技能。触发语包括： - “帮我排版这个Word” - “自动格式化文档” - “统一字体行距” - “论文/报告排版” - “Word排版” - “整理文档格式” - “format this Word file” - “auto typeset” - “standardize document style” 该技能提供一个 Python 脚本（`word_formatter.py`），可
以下为完整实现示例：
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<String, Object> 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)）尝试修补环境，那已为时已晚。
