???

??一、核心概念?

配置文件	默認存在	加載順序	優先級	主要用途	必需依賴
bootstrap.yml	? 無	1(最先)	最高	Spring Cloud上下文初始化	spring-cloud-starter-bootstrap
bootstrap.properties	? 無	1(略高于.yml)	最高	同上	同上
application.yml	? 自動創建	2	中等	應用核心配置	無
application.properties	? 自動創建	2(高于.yml)	中等	同上	無

??Spring Boot 2.4+ 必須顯式添加spring-cloud-starter-bootstrap依賴才會加載bootstrap.*文件！

---

??二、詳細加載機制解析??

??1. 標準Spring Boot項目（無Spring Cloud）??

• ??僅生效文件??：application.yml/application.properties
• ??加載順序??：
  1. application.properties（若存在）
  2. application.yml（覆蓋同名屬性）

??2. Spring Cloud項目??

• ??完整加載順序??：
  1. bootstrap.yml → bootstrap.properties（需依賴）
  2. application.yml → application.properties
• ??典型用途??：
  • bootstrap.*：配置Config Server地址、加密密鑰等
  • application.*：數據庫連接、服務端口等常規配置

---

??三、版本兼容性矩陣??

Spring Boot版本	Bootstrap機制	推薦做法
??2.3及以下??	自動加載	無需額外依賴
??2.4~2.7??	需顯式添加依賴	必須引入spring-cloud-starter-bootstrap
??3.0+??	已移除	改用spring.config.import

???? 重要??：
Spring Boot 3.x 用戶應參考官方指南，不再使用bootstrap.*文件。

---

??四、依賴管理實戰??

??Maven項目配置示例??

<!-- Spring Boot 2.6 + Spring Cloud 2021.0.3 -->
<properties><spring-cloud.version>2021.0.3</spring-cloud.version>
</properties><dependencies><!-- 關鍵依賴！ --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId></dependency><!-- 其他Cloud組件 --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-config</artifactId></dependency>
</dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>${spring-cloud.version}</version><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement>

??Gradle項目配置示例??

ext {set('springCloudVersion', "2021.0.3")
}dependencies {implementation 'org.springframework.cloud:spring-cloud-starter-bootstrap'implementation 'org.springframework.cloud:spring-cloud-starter-config'
}dependencyManagement {imports {mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"}
}

---

??五、配置優先級驗證方法??

??1. 通過Actuator端點檢查??

1. 添加依賴：

   <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId>
   </dependency>

2. 訪問：http://localhost:8080/actuator/env
3. 查找propertySources列表，確認加載順序

??2. 日志驗證??

啟動時添加--debug參數：

java -jar your-app.jar --debug

在日志中搜索：

Loaded config file 'classpath:/bootstrap.yml'
Loaded config file 'classpath:/application.yml'

---

??六、多環境配置最佳實踐??

??1. 標準多環境配置??

resources/
├── application.yml          # 主配置
├── application-dev.yml      # 開發環境
├── application-prod.yml     # 生產環境
└── bootstrap.yml            # Cloud配置(可選)

激活指定環境：

java -jar app.jar --spring.profiles.active=prod

??2. 配置覆蓋規則示例??

# bootstrap.yml
spring:cloud:config:uri: http://config-server:8888  # 最高優先級# application-dev.yml
server:port: 8081  # 會被bootstrap中的配置覆蓋(如果存在同名屬性)

---

??七、常見問題解決方案??

??Q1: Spring Boot 2.6+ bootstrap.yml不生效？??

• ??檢查項??：
  1. 是否添加了spring-cloud-starter-bootstrap依賴
  2. 依賴版本是否與Spring Cloud版本匹配
  3. 是否誤用了Spring Boot 3.x

??Q2: 如何調試配置加載過程？??

1. 啟用調試日志：

   # application.properties
   logging.level.org.springframework.boot.context.config=DEBUG

2. 檢查日志中的PropertySource加載順序

??Q3: 需要覆蓋bootstrap.*中的配置怎么辦？??

• 在application.*中使用??相同屬性名??即可覆蓋
• 或通過環境變量/命令行參數覆蓋（最高優先級）

---

??八、總結流程圖??

graph TDA[啟動應用] --> B{是否存在spring-cloud-starter-bootstrap?}B -->|是| C[加載bootstrap.yml]B -->|否| D[跳過bootstrap]C --> E[加載application.yml]D --> EE --> F[應用最終配置]

---

??最終建議??：

1. 新項目優先使用Spring Boot 3.x + spring.config.import
2. 維護項目按版本嚴格遵循本指南
3. 多環境配置務必使用application-{profile}.yml模式