一、核心原理：配置是如何加載的？

在 Spring Cloud 生態(tài)中，應(yīng)用啟動(dòng)時(shí)會經(jīng)歷兩個(gè)上下文階段：

1.Bootstrap Context（引導(dǎo)上下文）

• 在主應(yīng)用上下文（Application Context）之前初始化。
• 用于加載外部化配置源（如 Nacos、Consul、Vault 等）。
• 由 bootstrap.yml / bootstrap.properties 驅(qū)動(dòng)。
• 此階段會連接 Nacos Server，拉取遠(yuǎn)程配置，并注入到后續(xù)的主上下文中。

? 關(guān)鍵點(diǎn)：Nacos 的遠(yuǎn)程配置是在 Bootstrap 階段被拉取并合并到 Environment 中的。

2.Application Context（應(yīng)用上下文）

• 加載 application.yml 等本地配置。
• 合并來自 Bootstrap 階段的遠(yuǎn)程配置。
• 最終形成一個(gè)統(tǒng)一的 Environment 對象，供 @Value、@ConfigurationProperties 使用。

Spring 的 PropertySource 機(jī)制決定了：后加入的 PropertySource 優(yōu)先級更高。而 Nacos 的遠(yuǎn)程配置正是在 Bootstrap 階段早于本地 application.yml 被加入，但其 PropertySource 的 order 被設(shè)計(jì)為更高優(yōu)先級（即數(shù)值更?。瑥亩鴮?shí)現(xiàn)“覆蓋本地配置”。

技術(shù)細(xì)節(jié)：

Nacos 通過 NacosPropertySourceLocator 創(chuàng)建 NacosPropertySource，其 getPropertySources() 返回的列表會被 插入到 Spring Environment 的靠前位置（高優(yōu)先級）。

二、配置優(yōu)先級順序（由高到低）

以下是 Spring Boot + Spring Cloud Alibaba + Nacos 組合下的完整配置優(yōu)先級（基于官方文檔與源碼驗(yàn)證）：

重點(diǎn)結(jié)論：

Nacos 配置的優(yōu)先級高于本地 application.yml，但低于命令行和環(huán)境變量。

這意味著：你可以用 Nacos 管理大部分配置，同時(shí)保留通過環(huán)境變量或啟動(dòng)參數(shù)臨時(shí)覆蓋的能力（運(yùn)維友好）。

三、典型應(yīng)用場景

場景 1：多環(huán)境配置管理（Dev / Test / Prod）

做法：在 Nacos 中創(chuàng)建不同 Data ID，如：

• user-service-dev.yaml
• user-service-test.yaml
• user-service-prod.yaml

本地 bootstrap.yml：

spring:
  profiles:
    active: prod  # 決定加載哪個(gè) profile 的 Nacos 配置
  cloud:
    nacos:
      config:
        server-addr: nacos.example.com:8848
        file-extension: yaml

• 效果：無需修改代碼，切換環(huán)境只需改 active profile，Nacos 自動(dòng)加載對應(yīng)配置。

場景 2：動(dòng)態(tài)刷新配置（@RefreshScope）

• 修改 Nacos 中的配置 → 應(yīng)用自動(dòng)更新（無需重啟）。
• 本地 application.yml 中的同名配置會被忽略（因?yàn)?Nacos 優(yōu)先級更高）。
• 適用于：限流閾值、開關(guān)標(biāo)志、日志級別等運(yùn)行時(shí)可變參數(shù)。

場景 3：安全敏感配置外置

• 數(shù)據(jù)庫密碼、AK/SK、OAuth 密鑰等絕不寫入代碼倉庫。
• 全部托管在 Nacos（配合權(quán)限控制 + 加密插件）。
• 本地 application.yml 只保留非敏感默認(rèn)值。

四、優(yōu)缺點(diǎn)對比分析

最佳實(shí)踐建議：

• 開發(fā)階段：本地 application.yml 為主，快速迭代。
• 測試/生產(chǎn)階段：Nacos 為主，本地僅保留 fallback 默認(rèn)值。
• 關(guān)鍵配置：永遠(yuǎn)不要把密碼、密鑰寫進(jìn) Git！

五、注意事項(xiàng) & 常見陷阱

Spring Boot 2.4+ 默認(rèn)禁用 bootstrap.yml

需顯式引入：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

Data ID 命名規(guī)則必須匹配

默認(rèn)格式：${spring.application.name}.${file-extension}

若不匹配，Nacos 配置不會被加載！

配置覆蓋不是“替換”，而是“合并”

Nacos 和本地配置會 merge，只有同名 key 才會被覆蓋。

優(yōu)先級可通過 spring.cloud.config.override-none=true 調(diào)整（不推薦）

一般保持默認(rèn)行為即可。

總結(jié)

Nacos 配置中心 ? 本地 application.yml ? bootstrap.yml（功能不同）

• 原理上：Nacos 配置通過 Bootstrap Context 注入高優(yōu)先級 PropertySource。
• 實(shí)踐中：Nacos 用于生產(chǎn)環(huán)境集中管理 + 動(dòng)態(tài)更新，本地配置用于開發(fā)默認(rèn)值。
• 架構(gòu)上：這是云原生“配置外置”理念的核心體現(xiàn)，提升系統(tǒng)彈性與可運(yùn)維性。

合理利用這一優(yōu)先級機(jī)制，能讓你的微服務(wù)既靈活又安全，真正實(shí)現(xiàn) “一次構(gòu)建，隨處部署” 的 DevOps 目標(biāo)。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評論