CommandLineRunner在Spring Boot上下文刷新完成、所有非懒加载Bean初始化后执行；依赖懒加载Bean会触发隐式初始化；按@Order或Ordered顺序执行；未捕获异常导致应用退出；参数解析推荐ApplicationRunner；不可用于定时任务或健康检查。
CommandLineRunner 执行时机和触发条件
它只在 Spring Boot 应用上下文完全刷新（refresh）完成后、且所有 Bean 都已初始化完毕时才执行，不是“一启动就跑”，更不是 main 方法结束就跑。如果你依赖某个 @Service 或 @Repository，它们一定已经就绪；但若依赖的 Bean 是懒加载（@Lazy），那它可能还没被创建——这时候调用会触发初始化，但属于隐式行为，容易误判生命周期。
- 多个
CommandLineRunner实例默认按注册顺序执行，不保证类加载顺序 - 想控制先后？加
@Order注解或让类实现Ordered接口，数值越小越靠前 - 如果抛出未捕获异常，应用直接退出（Spring Boot 默认不吞异常），这点和
ApplicationRunner一致
CommandLineRunner 和 ApplicationRunner 到底选哪个
核心区别在参数：前者接收 String[] args，后者接收封装好的 ApplicationArguments。如果你要解析带选项的命令行（比如 --server.port=8081 --profile=prod），ApplicationArguments 提供 getOptionNames()、getOptionValues()、getNonOptionArgs()，比手动切分 String[] 更安全可靠；但如果你只是检查有没有传参、或只做简单开关判断（如 args.length > 0），用 CommandLineRunner 更轻量。
-
CommandLineRunner的args包含所有 JVM 参数之后的内容，不含-D或--spring.profiles.active这类 Spring Boot 内部参数 -
ApplicationRunner的ApplicationArguments会过滤掉 Spring Boot 已消费的参数，只留“用户自定义”部分 - 两者不能混用逻辑来规避参数解析问题——选一个，用到底
常见踩坑：数据库还没连上就去查表
典型错误是写个 CommandLineRunner 去调 userRepository.findAll()，结果报 org.hibernate.HibernateException: No Session found for current thread 或连接超时。这不是 Runner 本身的问题，而是你没确认数据源是否 ready：JPA 的 EntityManagerFactory 初始化可能稍晚于普通 Bean，尤其启用了 Liquibase 或 Hibernate ddl-auto=create 时。
- 加个简单检查：
if (dataSource != null && dataSource.getConnection() != null)不可靠，连接可能被池回收；应依赖 Spring 的DataSourceHealthIndicator或监听ContextRefreshedEvent - 更稳妥的做法：把数据库操作包装进
@Transactional方法里，由 Spring 管理事务上下文 - 如果任务必须等 schema 初始化完，考虑监听
DataSourceInitializedEvent（仅限 Spring Boot 2.x）或改用ApplicationRunner+ 主动 sleep（不推荐）
别把它当定时任务或健康检查入口
CommandLineRunner 是一次性执行，不是循环钩子。有人试图在里面写 while(true) { Thread.sleep(60_000); doSomething(); }，结果阻塞主线程，导致 Actuator 端点无法响应、HTTP server 启动失败——因为 Spring Boot 认为“启动完成”的标志就是所有 Runner 执行完并返回。
- 长期运行逻辑请用
@Scheduled（需开@EnableScheduling）或TaskExecutor提交异步任务 - 健康检查逻辑应走 Actuator 的
HealthIndicator接口，而非塞进 Runner - 如果任务耗时超过 30 秒，建议加日志标记开始/结束，并考虑设置 JVM 启动参数
--spring.main.web-application-type=none避免 Web 容器等待超时
真正难处理的是跨服务依赖——比如 Runner 里要调另一个微服务的接口，而那个服务还没起来。这时候没有银弹，只能加重试、降级或改用事件驱动（如发消息到 RabbitMQ，等对方就绪再消费）。
