Spring中初始化方法需按场景选择：@PostConstruct用于Bean级初始化后；CommandLineRunner/ApplicationRunner用于应用启动完成时；@EventListener监听ContextRefreshedEvent确保上下文完全就绪；@Bean(initMethod)适用于工厂创建的Bean。
在 Spring 中，初始化方法执行业务逻辑的关键是明确“初始化”的具体阶段：是单个 Bean 的初始化完成，还是整个应用上下文启动就绪。不同场景对应不同机制，选错容易导致依赖未就绪、空指针或逻辑未触发。
@PostConstruct：Bean 级别初始化后立即执行
适用于当前 Bean 依赖已注入完毕、需做自身专属准备的场景（如连接池初始化、配置校验）。
- 方法必须无参、返回 void，且不能是 private
- 执行时机早于其他 Bean 的 @PostConstruct，但不保证所有 Bean 都已初始化完成
- 不能直接依赖尚未加载的其他 Bean（比如被 @Lazy 或条件装配控制的组件）
示例：
@Component
public class CacheManager {
@Autowired private RedisTemplate redisTemplate;
@PostConstruct
public void init() {
System.out.println("CacheManager 初始化：清空旧缓存并预热基础数据");
redisTemplate.delete("system_config");
loadBasicConfig(); // 本类内部方法，安全
}
}
CommandLineRunner / ApplicationRunner：应用级启动完成时执行
这是最常用、最推荐的方式，适用于真正需要“项目完全启动后”才运行的逻辑，比如缓存预热、服务注册、定时任务启动。
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- CommandLineRunner 接收 String[] args，适合简单参数解析
- ApplicationRunner 接收 ApplicationArguments，支持 --key=value 格式解析，更健壮
- 多个实现可通过 @Order 控制顺序，数值越小越先执行
- 此时 ApplicationContext 已刷新完毕，所有单例 Bean 可安全获取
示例（ApplicationRunner）：
@Component
@Order(1)
public class DataPreloader implements ApplicationRunner {
@Autowired private UserService userService;
@Autowired private CacheService cacheService;
@Override
public void run(ApplicationArguments args) throws Exception {
if (args.containsOption("preload")) {
System.out.println("按参数启用数据预热");
cacheService.warmUpAllUsers(userService.findAll());
}
}
}
@EventListener 监听 ContextRefreshedEvent：上下文完全就绪后触发
当需要在所有 Bean（包括第三方自动配置的 Bean）都完成初始化后执行逻辑，且不希望绑定到某个特定 Runner 类时适用。
- 监听 ContextRefreshedEvent，确保 Spring 容器彻底准备就绪
- 适合做全局检查、健康上报、跨模块协同初始化
- 注意：该事件可能触发多次（如子上下文刷新），可用 static 标志或 ApplicationRunner 替代规避重复
示例：
@Component
public class SystemReadyChecker {
private static boolean checked = false;
@EventListener
public void onContextRefresh(ContextRefreshedEvent event) {
if (!checked && event.getApplicationContext().getParent() == null) {
System.out.println("主容器刷新完成，执行系统就绪检查");
validateExternalServices();
checked = true;
}
}
}
@Bean(initMethod)：自定义 Bean 创建后的初始化回调
适用于非 @Component 管理的 Bean（比如手动 new 或工厂创建的对象），需要在 Spring 注入依赖后调用指定方法。
- initMethod 指向一个无参、public、void 方法
- 与 @PostConstruct 行为类似，但作用于 XML 或 @Bean 声明的 Bean
- 不适用于常规注解扫描的组件，属于较老但仍有价值的方式
示例：
@Configuration
public class AppConfig {
@Bean(initMethod = "init")
public DataSource dataSource() {
return new HikariDataSource();
}
}
// 对应 DataSource 类中需有：
public void init() {
System.out.println("数据源连接池初始化完成");
}
