理解 SpringCloud Nacos 配置文件的加载顺序与优先级

Nacos 配置文件分类与优先级详解

在使用 Spring Cloud Alibaba Nacos 的微服务架构中，配置文件的管理至关重要。本文将详细介绍 Nacos 环境中的配置文件分类、加载顺序及其优先级，以帮助开发者更好地理解如何配置和管理应用程序。

1. 配置文件分类

在 Nacos 环境中，主要涉及以下几种类型的配置文件：

本地配置文件

• bootstrap.yml / bootstrap.yaml：用于在应用启动时配置环境，通常包含与服务注册和发现相关的配置信息。
• application.yml / application.yaml：用于定义应用的具体配置信息，包括数据库连接、日志配置等。

Nacos 配置中心的配置文件

• 共享配置文件 (shared-configs)：这些配置文件可以被多个服务共享，适合存放通用的配置信息。
• 扩展配置文件 (extension-configs)：用于对共享配置进行扩展，适合个性化的配置需求。
• 项目应用名配置文件 (${spring.application.name}.yaml / .properties)：特定于某个应用的配置文件，通常用于存放该应用独有的配置。

2. 加载顺序

理解加载顺序对于确保配置的正确应用至关重要。Nacos 的加载顺序如下：

1. bootstrap.yml / bootstrap.yaml：在应用启动时首先加载，负责设置基本的启动环境。
2. Nacos 配置中心的配置文件：
   • 共享配置文件 (shared-configs)：首先加载，适用于所有服务。
   • 扩展配置文件 (extension-configs)：接着加载，用于补充或修改共享配置。
   • 项目应用名配置文件 (${spring.application.name}.yaml / .properties)：最后加载，针对特定应用的配置。
3. application.yml / application.yaml：在 Nacos 配置加载之后进行加载，通常用于存放更多细节配置。

3. 配置优先级

配置优先级决定了在多个配置文件中相同配置项的最终值。优先级从高到低排列如下：

1. 项目应用名配置文件：最高优先级，覆盖其他所有配置。
2. 扩展配置文件：次高优先级，覆盖共享配置。
3. 共享配置文件：优先级低于扩展配置。
4. 本地 application.yml / application.yaml：优先级低于所有从 Nacos 加载的配置。
5. 本地 bootstrap.yml / bootstrap.yaml：优先级最低。

4. 本地配置优先的设置

在某些场景下，可能需要确保本地配置优先于 Nacos 的远程配置。这可以通过在 bootstrap.yml 或 application.yml 中添加以下配置来实现：

spring:
  cloud:
    config:
      override-none: true

设置 override-none 为 true 时，本地配置文件 (application.yml / application.yaml) 将具有最高优先级，允许在不同环境中灵活覆盖远程配置。