在当今的互联网软件开发领域，Spring Boot 无疑是最为热门和广泛应用的框架之一。它以其强大的功能、便捷的开发体验，极大地提升了开发效率，成为众多开发者构建 Web 应用程序的首选。而在 Spring Boot 的众多特性中，配置文件的加载机制对于我们开发出高效、稳定且可灵活适应不同环境的应用至关重要。尤其是在 Spring Boot3 版本中，配置文件加载顺序有着其特定的规则和优先级，今天我们就来深入探讨一番。

为什么要了解配置文件加载顺序

在开发互联网软件项目时，我们往往会面临多种不同的环境，比如开发环境、测试环境、生产环境等。不同环境下，应用程序可能需要不同的配置，像数据库连接地址、服务器端口、日志级别等。合理地管理这些配置，并确保在不同环境下应用能正确加载所需配置，是保障应用稳定运行的基础。如果不了解 Spring Boot3 中配置文件的加载顺序，可能会导致配置冲突、错误的配置生效等问题，进而影响应用的功能和性能。例如，在生产环境中错误地加载了开发环境的数据库配置，那后果将不堪设想。

Spring Boot3 配置文件加载顺序详解

Spring Boot3 支持多种配置文件格式，常见的有 properties 和 yml（yaml）。其配置文件的加载顺序遵循一套严谨的优先级规则，下面我们从最高优先级开始依次介绍。

命令行参数

命令行参数在 Spring Boot3 的配置加载中拥有最高优先级。通过在启动命令中使用--key=value的形式传递参数，能直接覆盖其他任何来源的配置。例如，我们在启动应用时使用java -jar app.jar --server.port=8081，这样无论其他配置文件中如何设置server.port，应用最终都会使用 8081 作为服务器端口。这种方式特别适合临时调整配置，比如在进行一些特定测试时，临时修改某个配置项，而无需去修改配置文件。

SPRING_APPLICATION_JSON

SPRING_APPLICATION_JSON可以通过环境变量或系统属性来设置，它支持内联 JSON 格式的配置。例如，我们可以在启动命令中使用-Dspring.application.json='{"myConfigKey":"myConfigValue"}'，或者在环境变量中设置SPRING_APPLICATION_JSON='{"myConfigKey":"myConfigValue"}'。这种方式提供了一种灵活的配置方式，尤其适用于一些需要动态生成配置的场景，比如在容器编排工具（如 Docker、Kubernetes）中，可以方便地通过环境变量来传递复杂的配置信息。

JNDI 属性（java:comp/env）

从 JNDI 上下文获取的属性也会被 Spring Boot 加载为配置。在一些企业级应用中，可能会使用 JNDI 来集中管理配置信息，Spring Boot 能够很好地集成这种方式。不过，这种方式在实际的互联网软件开发项目中相对使用较少，更多地出现在传统的企业级 Java 应用开发场景中。

ServletConfig 初始化参数

在 Servlet 3.0 及以上版本中，我们可以通过@WebServlet注解或者在web.xml文件中定义 ServletConfig 初始化参数。例如，在web.xml中配置：

<servlet>
    <servlet-name>myServlet</servlet-name>
    <servlet-class>com.example.MyServlet</servlet-class>
    <init-param>
        <param-name>myConfigParam</param-name>
        <param-value>configValue</param-value>
    </init-param>
</servlet>

这些初始化参数也会被 Spring Boot 纳入配置体系，但同样，在现代基于 Spring Boot 的互联网开发中，这种方式逐渐不那么常用，更多地用于兼容一些遗留项目。

ServletContext 初始化参数

类似于 ServletConfig 初始化参数，ServletContext 初始化参数作用于整个应用上下文。它可以在web.xml中进行配置，如下所示：

<context-param>
    <param-name>myContextConfigParam</param-name>
    <param-value>contextConfigValue</param-value>
</context-param>

同样，在新开发的 Spring Boot 项目中，这种配置方式使用频率较低。

JVM 系统属性（-D参数）

通过在启动命令中使用-D参数设置的系统属性，也会被 Spring Boot 加载。例如，java -jar app.jar -Dspring.datasource.url=
jdbc:mysql://localhost:3306/mydb，这里设置的spring.datasource.url属性会被应用读取。这种方式在一些需要在启动时动态指定一些系统级配置的场景中比较有用。

操作系统环境变量

操作系统环境变量也是配置的重要来源。在 Spring Boot 中，环境变量名需要转换为大写并使用下划线分隔。比如，配置文件中的
spring.datasource.username，在环境变量中需要写成
SPRING_DATASOURCE_USERNAME。在容器化部署中，通过设置环境变量来传递配置信息是非常常见的做法，这样可以方便地在不同的部署环境中灵活切换配置，而无需修改应用的代码和配置文件。

Profile-specific 配置文件

Spring Boot 支持根据不同的 Profile 加载特定的配置文件。通过设置spring.profiles.active属性来激活相应的 Profile。Profile-specific 配置文件的命名格式为application-{profile}.yml或application-{profile}.properties，例如application-dev.yml、
application-prod.properties等。这些特定 Profile 的配置文件优先级高于默认配置文件，但低于前面提到的更高优先级的配置源。当激活多个 Profile 时，后面声明的 Profile 配置会覆盖前面同名的配置项。比如，同时激活了prod和metrics两个 Profile，且application-prod.yml和application-metrics.yml中都有对server.metrics.enabled的配置，那么application-metrics.yml中的配置将生效。

默认配置文件

默认配置文件指的是application.yml和application.properties。它们可以存在于项目的src/main/resources目录下，也可以作为外部文件存在。加载顺序上，外部文件优先于内部文件。并且，如果application.yml和application.properties同时存在且有相同的配置项，application.yml中的配置会覆盖application.properties。这两个默认配置文件是我们在开发中最常用的配置文件，通常会将一些通用的、不随环境变化的配置放在这里。

@PropertySource注解加载的配置文件

通过在@Configuration类上使用@PropertySource注解，可以加载自定义的配置文件。例如：

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;

@Configuration
@PropertySource("classpath:custom.properties")
public class CustomConfig {
    // 配置类相关代码
}

这种方式适用于加载一些特定模块或功能的配置文件，不过其优先级相对较低。

默认属性（SpringApplication.setDefaultProperties）

通过代码
SpringApplication.setDefaultProperties设置的默认属性，是优先级最低的配置源。这种方式在实际开发中使用较少，因为它不够灵活，一旦设置，在整个应用中都是固定的，很难根据不同环境进行调整。

配置文件加载顺序案例分析

为了更直观地理解 Spring Boot3 中配置文件的加载顺序，我们来看一个具体的案例。假设我们有一个 Spring Boot 应用，包含以下几个配置文件和配置方式：

• 在src/main/resources目录下有application.yml，其中设置server.port: 8080。
• 在src/main/resources目录下有application-dev.yml，其中设置server.port: 8082，并且通过spring.profiles.active: dev激活了dev Profile。
• 在操作系统环境变量中设置SPRING_APPLICATION_JSON='{"server":{"port":8083}}'。
• 通过命令行参数启动应用：java -jar app.jar --server.port=8084。

在这个案例中，最终应用使用的服务器端口将是 8084，因为命令行参数具有最高优先级。如果去掉命令行参数，那么应用将使用 8083 作为服务器端口，因为SPRING_APPLICATION_JSON的优先级高于 Profile-specific 配置文件和默认配置文件。如果再去掉SPRING_APPLICATION_JSON环境变量设置，那么应用将使用 8082 作为服务器端口，因为application-dev.yml中的配置覆盖了application.yml中的配置。

最佳实践与注意事项

合理利用优先级：在开发中，要根据配置的性质和使用场景，合理选择配置方式和配置文件。对于一些敏感信息，如数据库密码，建议通过命令行参数或环境变量来传递，这样可以提高安全性，避免配置文件泄露导致的安全风险。对于不同环境的差异化配置，优先使用 Profile-specific 配置文件，将通用配置放在默认配置文件中。

避免配置冲突：由于配置文件存在优先级和覆盖关系，在编写配置时要格外小心，避免出现同名配置项在不同优先级的配置文件中设置不同值，导致难以排查的问题。在团队开发中，要建立统一的配置管理规范，明确哪些配置应该放在哪里，防止因多人随意修改配置而引发冲突。

灵活运用外部配置：尽量将配置文件放在外部，而不是打包在 Jar 包内部。这样在应用部署后，如果需要修改配置，无需重新打包和部署应用，只需直接修改外部配置文件即可。可以通过spring.config.location和
spring.config.additional-location等属性来指定外部配置文件的位置。

注意配置文件格式：虽然 Spring Boot 支持多种配置文件格式，但在一个项目中尽量保持一致，避免同时使用多种格式的配置文件，以免增加配置管理的复杂性。如果使用 YAML 格式，要注意其语法的严格性，特别是缩进和冒号的使用。

了解 Spring Boot3 中配置文件的加载顺序，对于我们开发高质量、可维护、可灵活部署的互联网软件应用至关重要。希望通过本文的介绍，能帮助各位开发者在实际项目中更好地管理和运用配置，提升开发效率和应用的稳定性。