美团二面：SpringBoot读取配置优先级顺序是什么？

2024-05-10 19:12
文章标签 java 配置 读取 springboot spring 优先级 顺序 美团 二面

本文主要是介绍美团二面：SpringBoot读取配置优先级顺序是什么？，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

引言

Spring Boot作为一种轻量级的Java应用程序框架，以其开箱即用、快速搭建新项目的特性赢得了广大开发者的青睐。其核心理念之一就是简化配置过程，使开发者能够快速响应复杂多变的生产环境需求。为了实现这一点，Spring Boot支持丰富的外部化配置机制，允许应用程序根据不同的部署环境灵活加载相应的配置属性，而无需修改代码本身。

在Spring Boot生态系统中，配置属性可以从各种来源获取，比如：Java属性文件、YAML文件、环境变量、命令行参数等。这些配置属性能够在运行时动态注入到Bean中，极大地提高了系统的可扩展性和可配置性。然而，为了确保一致性和防止配置冲突，Spring Boot在加载这些外部配置时遵循一套严格的优先级顺序。掌握这套优先级规则至关重要，因为它直接影响着最终生效的配置属性值，进而决定了应用程序的行为模式。

本文将深入探讨Spring Boot加载外部配置属性的优先级规则，详尽梳理各个配置源的加载顺序，并结合实际应用场景举例说明，以便我们能够更高效地管理和迁移配置，确保在不同环境下应用程序都能稳定、准确地运行。

Spring Boot外部化配置概述

Spring Boot的核心价值之一在于其强大的外部化配置能力，这使得应用程序能够在不改变代码的情况下适应不同的运行环境。外部化配置意味着将应用程序的关键配置信息移至应用程序代码之外，便于根据不同环境（如开发、测试、生产等）进行定制化配置。Spring Boot提供了多样化的外部配置源以及便捷的属性注入方式，使得这种配置机制变得异常灵活且易于管理。

多样化配置源

Spring Boot支持多种类型的外部配置源，主要有如下几个方面：

  1. Properties文件:
    通常使用.properties格式，采用键值对的形式存储配置信息。
server.port=8080
logging.level.root=DEBUG
  1. YAML文件：
    相较于传统的properties文件，YAML提供了更直观、层次更分明的数据结构，尤其适合存储复杂配置。使用.yml格式。
server:port: 8080
logging:level:root: DEBUG

  1. 环境变量：
    操作系统级别的环境变量可以被Spring Boot识别并作为配置源，这对于云环境和容器化部署尤为实用。

  2. 命令行参数：
    启动Spring Boot应用时，可以传入命令行参数（以--开头）直接覆盖已有配置。

属性注入方式

在Spring Boot中，外部配置的属性值可以通过以下几种方式方便地注入到Bean中。

  • @Value注解：可以直接在字段或方法参数上使用此注解，将配置属性值注入到目标对象中。

  • Environment接口：Spring框架提供的环境抽象类，可以用来查询所有已加载的配置信息。

  • @ConfigurationProperties注解：用于绑定一组相关配置到一个专门的Java Bean中，提供更结构化的配置管理方式。

配置加载优先级

Spring Boot对来自不同配置源的同名属性可以按照一定的优先级顺序进行覆盖。其优先级从上到下变高，即后面的配置源将覆盖前面的配置源。

  1. 默认属性（通过SpringApplication.setDefaultProperties方法设置）
  2. @PropertySource注解加载的配置
  3. Config Data（配置数据）（本地文件系统或打包在jar中的application.properties和application-{profile}.properties）
  4. 特殊属性源（如随机数生成器、环境变量、系统属性、JNDI属性等）
  5. Servlet容器相关的初始化参数
  6. SPRING_APPLICATION_JSON格式的环境变量或系统属性
  7. 命令行参数
  8. 测试相关的属性注入方式（如@SpringBootTest、@DynamicPropertySource和@TestPropertySource）

以上优先级顺序来源于官网：Spring Boot Reference Documentation

Spring Boot配置加载顺序详解

默认属性

默认属性是指Spring Boot框架内置的一些默认配置值。可以在创建SpringApplication实例时，通过调用setDefaultProperties(Map<String, Object> defaultProperties)方法来提供一组默认属性，这些属性将被优先加载，但是也会被其他配置覆盖。

@SpringBootApplication
public class SpringBootBaseApplication {public static void main(String[] args) {Map<String, Object> defaultProperties = new HashMap<>();defaultProperties.put("server.port", "9000"); // 自定义默认端口SpringApplication app = new SpringApplication(SpringBootBaseApplication.class);app.setDefaultProperties(defaultProperties);app.run(args);}
}

image.png

@PropertySource注解

@PropertySource注解用于在Spring Boot的@Configuration类上加载外部属性文件。当我们在配置类上使用@PropertySource时，需要注意的是，这些属性源并不会立即被添加到Spring的Environment中。它们是在Spring应用上下文刷新（refresh）阶段才会被真正加载并合并到环境变量中。

有兴趣的可以跟一下源码，org.springframework.context.support.AbstractApplicationContext#invokeBeanFactoryPostProcessors中执行的。

Spring Boot的主引导配置，如服务器端口（server.port）、日志框架的初始化（例如日志级别设置）等，也是在应用上下文刷新之前就被读取并应用的。因此，对于这类早期就需要读取的配置，应该直接在application.properties或者环境变量等更早被加载的配置源中进行设置。

我们创建一个propertysource.properties文件：

server.port = 9001
coderacademy.name = CoderAcademy

然后我们在@Configuration配置上使用@PropertySource导入propertysource.properties文件。

@PropertySource(value = "classpath:propertysource.properties")
@Configuration
public class MyConfig {}

我们在应用启动后看一下上述配置：

@SpringBootApplication
public class SpringBootBaseApplication {public static void main(String[] args) {Map<String, Object> defaultProperties = new HashMap<>();defaultProperties.put("server.port", "9000"); // 自定义默认端口SpringApplication app = new SpringApplication(SpringBootBaseApplication.class);app.setDefaultProperties(defaultProperties);ConfigurableApplicationContext context = app.run(args);Environment environment = context.getEnvironment();System.out.println("coderacademy.name: " + environment.getProperty("coderacademy.name"));}
}

打印结果：
image.png

可以看出server.port变成了9001，即@PropertySource加载的配置覆盖了SpringBoot默认的属性值。

Config Data（配置数据）

Config Data（配置数据）是Spring Boot中用于外部化应用配置的核心部分。主要由内部配置文件以及外部配置文件。

内部配置文件

内部配置文件最基础的应用配置文件，位于项目构建后的jar包内部。位于src/main/resource目录下的文件。

image.png

外部配置文件

可以将配置文件放在jar包外面的某个路径下。这种方式有助于在不修改jar包的情况下变更配置。比如我们使用的配置中心(nacos，apollo等)，也可以通过spring.config.location或者spring.config.additional-location指定的文件等。

SpringBoot在启动时会默认从特定的目录中加载这些配置文件。我们可以从ConfigDataEnvironment中找到这些目录：

image.png

其目录的加载顺序由低到高为：

file:./
file:./config/
file:./config/*/
classpath:/
classpath:/config/

其中file代表应用根目录下的文件，而classpath为resources下的文件。

这些配置文件的配置优先级顺序由低到高为：

classpath:/
classpath:/config/
file:./
file:./config/
file:./config/*/

本例基于SpringBoot2.7版本。
关于SpringBoot加载内部配置文件的执行流程以及原理，请参考：
华为二面：SpringBoot读取_配置文件_的原理是什么？加载顺序是什么？

我们分别在这些目录下创建配置文件application.properties：

我们在对应文件中写入他们的目录路径：

1: config.data.path = classpath:./
2: config.data.path = classpath:./config/
3: config.data.path = file:./
4: config.data.path = file:./config/
5: config.data.path = file:./config/dev

我们在SpringBoot启动时打印config.data.path的值：

@SpringBootApplication
public class SpringBootConfigApplication {public static void main(String[] args) {Map<String, Object> defaultProperties = new HashMap<>();defaultProperties.put("server.port", "9000"); // 自定义默认端口SpringApplication app = new SpringApplication(SpringBootConfigApplication.class);app.setDefaultProperties(defaultProperties);ConfigurableApplicationContext context = app.run(args);Environment environment = context.getEnvironment();System.out.println("config.data.path: " + environment.getProperty("config.data.path"));}
}

我们分步进行验证，先验证1,2，打印结果:

config.data.path: classpath:./config/

继续验证1,2,3，打印结果：

config.data.path: file:./

验证1,2,3,4,打印结果：

config.data.path: file:./config/

验证1,2,3,4,5,打印结果：

config.data.path: file:./config/dev

随机值属性源

RandomValuePropertySource 在Spring Boot中，RandomValuePropertySource是一个特殊属性源，它并不来源于固定的配置文件或环境变量，而是由Spring Boot框架在启动时自动添加。这个属性源提供的属性名以random.*开头，可以用于生成随机值。例如，你可以在配置文件中引用random.int或random.long等属性，Spring Boot在启动时会为这些属性生成随机整数值。这对于需要在运行时生成一些临时或随机值的场景非常有用，如临时密码、缓存密钥等。

比如我们在application.properties中设置random.int=100

random.int=100

我们在SpringBoot启动时获取``random.int`的值：

@SpringBootApplication
public class ConfigApplication
{public static void main( String[] args ){SpringApplication app = new SpringApplication(ConfigApplication.class);ConfigurableApplicationContext context = app.run(args);Environment environment = context.getEnvironment();System.out.println("random.int: " + environment.getProperty("random.int"));}
}

打印结果为：

random.int: -510589238

并且每次重新启动应用，打印的结果都不一样。

操作系统环境变量

在Spring Boot中，环境变量可以用作配置源，Spring Boot会自动检测并加载这些环境变量作为应用的配置属性。例如，如果在操作系统中设置了环境变量MY_APP_PORT=8080，那么在Spring Boot应用中可以通过${MY_APP_PORT}来引用这个值。

我们设置环境变量为config.data.path=环境变量:

image.png

我们启动引用，依然打印config.data.path的结果为：

config.data.path: 环境变量

Java系统属性

Java系统属性是通过System.setProperty()方法设置一系列键值对。

@SpringBootApplication
public class ConfigApplication
{static {System.setProperty("config.data.path", "SystemProperty"); // 设置系统属性}public static void main( String[] args ){SpringApplication app = new SpringApplication(ConfigApplication.class);ConfigurableApplicationContext context = app.run(args);Environment environment = context.getEnvironment();System.out.println("config.data.path: " + environment.getProperty("config.data.path"));}
}

打印结果为：

config.data.path: SystemProperty

SPRING_APPLICATION_JSON环境变量中的内嵌JSON属性

SPRING_APPLICATION_JSON 是 Spring Boot 提供的一种机制，允许通过环境变量传递 JSON 格式的配置给应用程序。这个环境变量的内容会被解析成一个 JSON 对象，并合并到Spring的Environment中，就像其他属性源一样。

@SpringBootApplication
public class ConfigApplication
{static {System.setProperty("config.data.path", "SystemProperty"); // 设置系统属性System.setProperty("SPRING_APPLICATION_JSON", "{\"config.data.path\":\"SPRING_APPLICATION_JSON环境变量中的内嵌JSON属性\"}");}public static void main( String[] args ){SpringApplication app = new SpringApplication(ConfigApplication.class);ConfigurableApplicationContext context = app.run(args);Environment environment = context.getEnvironment();System.out.println("config.data.path: " + environment.getProperty("config.data.path"));}
}

打印结果：

config.data.path: SPRING_APPLICATION_JSON环境变量中的内嵌JSON属性

命令行参数

启动Spring Boot应用时，可以直接通过命令行参数来覆盖或设置配置属性。命令行参数通常以--开头，后面紧跟属性名和值，如--server.port=8080。这种方式可以在不修改配置文件的前提下临时调整应用配置。命令行参数具有较高的优先级，可以覆盖其它配置源中的属性值。

我们使用java -jar启动SpringBoot：

java -jar ./springboot-config-1.0-SNAPSHOT.jar --config.data.path=命令行参数

打印结果为：

config.data.path: 命令行参数

关于SpringBoot的jar包，可以通过java -jar命令直接执行的原因请参考：字节二面：为什么SpringBoot的 jar 可以直接运行？我说内嵌了Tomcat容器，他让我出门左转

至于其他的跟单测有关的配置，我们就不一一细说了

总结

Spring Boot配置加载优先级的设计具有深远的实际意义和重要性。这一机制确保了应用在不同环境和部署场景下的高度灵活性和可移植性，同时也极大提升了开发和运维团队的生产力和协同效率。

优先级顺序的严谨性使得开发者能够精细地控制配置的覆盖层级，从而使同一份代码可以根据不同环境的需求加载不同的配置属性。例如，在开发、测试和生产环境中分别启用不同的数据库连接、日志级别或API密钥等敏感信息，而无需在代码中硬编码。

Spring Boot的配置加载流程首先考虑了默认配置，然后逐步加载用户通过@PropertySource注解引入的属性源、打包在jar包内外的各种application.properties和application-{profile}.properties或YAML文件、环境变量、系统属性，直至命令行参数等。这种分层加载策略确保了越靠后的配置源拥有更高的优先级，从而可以覆盖之前的配置，这也体现了配置的灵活性和即时性。

理解并合理运用Spring Boot配置加载的优先级，对于保障应用的安全性、可维护性以及降低部署复杂度至关重要。特别是在大规模微服务架构中，合理的配置管理和迁移对于整体系统的稳定性有着不可忽视的作用。通过对配置优先级的深入掌控，开发者和运维人员能够轻松应对复杂环境下的配置管理挑战，使得Spring Boot应用具备良好的扩展性和适应性。

本文已收录于我的个人博客：码农Academy的博客，专注分享Java技术干货，包括Java基础、Spring Boot、Spring Cloud、Mysql、Redis、Elasticsearch、中间件、架构设计、面试题、程序员攻略等。

这篇关于美团二面：SpringBoot读取配置优先级顺序是什么？的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/977310。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
Zookeeper安装和配置说明

Zookeeper安装和配置说明

一、Zookeeper的搭建方式 Zookeeper安装方式有三种，单机模式和集群模式以及伪集群模式。 ■ 单机模式：Zookeeper只运行在一台服务器上，适合测试环境； ■ 伪集群模式：就是在一台物理机上运行多个Zookeeper 实例； ■ 集群模式：Zookeeper运行于一个集群上，适合生产环境，这个计算机集群被称为一个“集合体”（ensemble） Zookeeper通过复制来实现
阅读更多...
CentOS7安装配置mysql5.7 tar免安装版

CentOS7安装配置mysql5.7 tar免安装版

一、CentOS7.4系统自带mariadb # 查看系统自带的Mariadb[root@localhost~]# rpm -qa|grep mariadbmariadb-libs-5.5.44-2.el7.centos.x86_64# 卸载系统自带的Mariadb[root@localhost ~]# rpm -e --nodeps mariadb-libs-5.5.44-2.el7
阅读更多...
hadoop开启回收站配置

hadoop开启回收站配置

开启回收站功能，可以将删除的文件在不超时的情况下，恢复原数据，起到防止误删除、备份等作用。 开启回收站功能参数说明 （1）默认值fs.trash.interval = 0，0表示禁用回收站；其他值表示设置文件的存活时间。 （2）默认值fs.trash.checkpoint.interval = 0，检查回收站的间隔时间。如果该值为0，则该值设置和fs.trash.interval的参数值相等。
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2