Spring Boot 3.x + Spring Cloud 2022：从 bootstrap.yml 到 application.yml 的迁移指南

在Spring Boot 3.x与Spring Cloud 2022的集成场景中，遇到了一个典型问题：将配置文件由application.yml改为bootstrap.yml并引入依赖spring-cloud-starter-bootstrap后，使用CI/CD流水线脚本部署jar服务时出现错误。然而，手动执行java -jar命令启动服务却毫无障碍。本文旨在解析这一问题，并提供解决方案。

背景

在尝试采用bootstrap.yml进行配置管理，并通过添加spring-cloud-starter-bootstrap依赖来实现Spring Cloud配置中心（如Nacos）的集成时，部署过程中出现了如下异常：

Caused by: java.lang.IllegalStateException: java.lang.IllegalStateException: Logback configuration error detected:ERROR in ch.qos.logback.core.rolling.RollingFileAppender[INFO_APPENDER] - Failed to create parent directories for

此错误表明，在Logback尝试初始化日志记录时，未能创建所需的父目录。进一步分析发现，这个问题仅在使用CI/CD工具自动化部署时发生，而手动启动则正常工作。

解决方案

官方建议不再使用bootstrap.yml，而是直接在application.yml中完成Nacos等配置中心的配置。根据这个指导原则，我们采取了以下措施解决了上述问题：

将bootstrap.yml重命名为application.yml。
移除spring-cloud-starter-bootstrap依赖。

启动流程对比

了解Spring Boot和Spring Cloud的启动流程有助于理解为何会出现此类问题及其解决方案背后的原理。

带Spring Cloud Bootstrap的启动流程
1. Bootstrap阶段：加载bootstrap.yml，创建Bootstrap Context，并拉取远程配置。
2. 主ApplicationContext阶段：加载application.yml及特定profile对应的配置文件，合并所有配置源。
3. Logback初始化阶段：根据完整的Environment解析变量，包括来自bootstrap.yml和application-{profile}.yml的配置。
不使用Bootstrap的简化流程
- 直接从application.yml开始加载配置，简化了配置加载逻辑，减少了潜在的配置冲突或路径权限问题。