重学SpringBoot3-各种配置的优先级对比

更多SpringBoot3内容请关注我的专栏：《SpringBoot3》
期待您的点赞👍收藏⭐评论✍

重学SpringBoot3-各种配置的优先级对比

Spring Boot 的核心设计之一是“约定优于配置”（Convention Over Configuration），这使得它能够根据默认值和用户提供的配置快速启动应用程序。然而，在实际开发中，应用的配置可能来自多个来源。理解这些配置来源的优先级非常重要，以便在配置冲突时确保程序按预期运行。

本文将详细介绍 Spring Boot 3 中的各种配置来源及其优先级，并提供实际案例和最佳实践。

1. 配置优先级概述

Spring Boot 3 的配置有以下几种来源（按照优先级从高到低排列）：

1. 命令行参数
2. java -D 系统属性
3. 环境变量
4. application.properties 或 application.yml- 位于 src/main/resources 中的默认配置- 外部配置文件
5. Profile-specific 配置- application-{profile}.properties 或 application-{profile}.yml
6. @PropertySource 注解
7. 默认属性

2. 各种配置来源的优先级详解

为了方便展示各种配置来源的优先级，下面将采用优先级从低到高的顺序依次展示各种配置的生效情况。

2.1 默认属性（最低优先级）

当启动项目没有提供某个属性时，则使用 Spring Boot 的默认值。

示例：
如果未配置

server.port

，则使用默认端口

8080

。

2.2

@PropertySource

注解

通过

@PropertySource

注解加载的配置文件优先级较低，但可以用于加载自定义的配置文件。

示例：

在

src/main/resources

目录下创建

custom.properties

文件：

server.port=8081

创建一个配置类，用

@PropertySource

加载自定义配置文件。

@Configuration@PropertySource("classpath:custom.properties")publicclassCustomConfig{}

启动项目，服务端口为自定义配置的8081。

2.3 配置文件（

application.properties

或

application.yml

）

application.properties

或

application.yml

是最常用的配置来源。它们可以存在于

src/main/resources

中，也可以作为外部文件。

加载顺序：

• 外部文件优先于内部文件（src/main/resources）。
• 文件名以 application 开头，默认加载 application.properties 或 application.yml。
• 位置从高到低优先级排序： 1. 当前目录2. /config 子目录3. JAR 包根目录

示例：

server:port:8082

2.4 Profile-specific 配置

Spring Boot 支持根据 Profile 加载特定的配置文件，例如

application-prod.yml

或

application-dev.yml

，这种方式可以帮助开发者轻松管理和切换开发、测试、生产等不同环境的配置。

默认未激活 Profile 情况下，

application.yml

优先级高于

application-dev.yml

。

激活 Profile 的方式：

1. 命令行参数：java -jar app.jar --spring.profiles.active=prod
2. 环境变量：exportSPRING_PROFILES_ACTIVE=prod
3. 配置文件中设置：spring:profiles:active: prod
4. IDEA配置 Active profiles:

优先级：
Profile-specific 文件的配置优先于

application.yml

使用场景：

• 根据环境动态加载不同的配置。

2.5 环境变量

操作系统级别的环境变量优先于配置文件，但低于命令行参数和系统属性。

示例：
在 Linux/Mac 上设置环境变量：

exportSERVER_PORT=8084

在 Windows 上设置环境变量：

set SERVER_PORT=8084

或 IDEA设置环境变量

启动应用后，Spring Boot 会自动解析环境变量

SERVER_PORT

并将其映射到

server.port

属性。

注意： 环境变量的名称为大写字母，并用下划线

_

替代点

.

。

使用场景：

• 为容器化部署（如 Docker）提供灵活的配置。
• 使用 CI/CD 工具注入环境变量。

2.6 系统属性（

java -D

）

通过 JVM 参数

-D

传递的系统属性次于命令行参数，但优先于其他来源。

示例：

java -Dserver.port=8085 -jar app.jar

或者通过 IDEA 设置 JVM 参数：

-Dserver.port=8085

此命令会将

server.port

设置为

8085

:

使用场景：

• 提供全局系统属性配置。
• 部署时设置 JVM 级别的变量。

2.7 命令行参数（最高优先级）

通过命令行参数传递的配置优先级最高。这通常用于在启动应用程序时临时修改配置，例如更改端口号或激活特定 Profile。

示例：

java -jar app.jar --server.port=8086

或者通过IDEA设置命令行参数：

此命令将优先于所有其他配置来源设置端口号为

8086

。

使用场景：

• 部署到生产环境时临时覆盖默认配置。
• 动态切换 Profile。

3. bootstrap.yml 和 application.yml优先级

bootstrap.yml

和

application.yml

都用于配置应用程序的属性，但它们的作用和优先级不同。以下是两者的详细对比和优先级说明：

3.1.

bootstrap.yml

的作用

• 加载时机：bootstrap.yml 在 application.yml之前加载。
• 主要用途： - 用于应用的引导配置。- 通常用于设置与 Spring Cloud 相关的配置，例如 spring.cloud.config.*。- 用于在 配置中心（如 Spring Cloud Config Server）中拉取远程配置。- 适合放置一些需要在应用初始化时就生效的属性，例如： - 配置文件路径- 加密解密密钥- 注册中心配置

示例：

# bootstrap.ymlspring:application:name: my-application
  cloud:config:uri: http://config-server:8888enabled:true

3.2.

application.yml

的作用

• 加载时机：application.yml 在 bootstrap.yml 加载之后。
• 主要用途： - 配置应用的主要属性，如端口号、数据源配置、日志配置等。- 一般是开发者最常用的配置文件。- 放置业务相关的配置。

示例：

# application.ymlserver:port:8080spring:datasource:url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: password

3.3. 优先级说明

在属性加载的优先级上：

1. **bootstrap.yml 优先于 application.yml**。 - 这是因为 bootstrap.yml 是 Spring Boot 启动时的引导配置，加载更早。- 属性从 bootstrap.yml 中加载后，会合并到 Spring 的环境中。
2. 如果 application.yml 中的属性和 bootstrap.yml 冲突： - 默认情况下，application.yml 中的属性会覆盖 bootstrap.yml 中的属性（除非 bootstrap.yml 的属性被标记为不可覆盖，如某些 Spring Cloud 配置）。

3.4. 典型使用场景

• bootstrap.yml 的场景：- 使用 Spring Cloud Config 或其他远程配置服务。- 初始化阶段的配置，例如 spring.application.name、spring.cloud.config.*。- 多环境或动态配置。
• application.yml 的场景：- 应用程序的业务配置。- 本地配置和日常开发使用。- 配置属性值可以被命令行参数、环境变量等覆盖。

3.5. 对比

特性

bootstrap.yml

application.yml

加载时机更早稍后用途引导配置，主要用于配置中心、初始化应用主要配置覆盖优先级属性优先级较低，但加载较早属性优先级较高推荐使用场景Spring Cloud Config、注册中心配置数据源、业务逻辑相关配置

4. 配置优先级冲突解析

从上面的示例可以看出，当同一个属性来自多个来源时，Spring Boot 按优先级选择高的配置。例如：

• 配置文件中 application.yml 设置：server:port:8085
• 同时命令行指定 --server.port=8086。

最终优先级选择结果为

8086

，因为命令行参数优先。

5. 最佳实践

1. 使用默认配置： 避免过度依赖多个来源，尽量使用 application.yml。
2. 使用 Profile-specific 文件： 区分开发、测试、生产环境。
3. 命令行参数覆盖配置： 部署时使用命令行参数灵活调整配置。
4. 记录配置来源： 在文档中记录不同配置的来源，便于排查问题。

6. 总结

Spring Boot 3 提供了丰富的配置机制，开发者可以根据实际需求选择合适的方式进行配置管理。了解这些配置来源的优先级，有助于在复杂项目中快速定位问题，提升项目的可维护性。