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

2024-05-10 19:12

本文主要是介绍美团二面: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包的情况下变更配置。比如我们使用的配置中心(nacosapollo等),也可以通过spring.config.location或者spring.config.additional-location指定的文件等。

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

image.png

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

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

其中file代表应用根目录下的文件,而classpathresources下的文件。

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

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.intrandom.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

相关文章

java使用protobuf-maven-plugin的插件编译proto文件详解

《java使用protobuf-maven-plugin的插件编译proto文件详解》:本文主要介绍java使用protobuf-maven-plugin的插件编译proto文件,具有很好的参考价... 目录protobuf文件作为数据传输和存储的协议主要介绍在Java使用maven编译proto文件的插件

Jenkins分布式集群配置方式

《Jenkins分布式集群配置方式》:本文主要介绍Jenkins分布式集群配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1.安装jenkins2.配置集群总结Jenkins是一个开源项目,它提供了一个容易使用的持续集成系统,并且提供了大量的plugin满

Java中的数组与集合基本用法详解

《Java中的数组与集合基本用法详解》本文介绍了Java数组和集合框架的基础知识,数组部分涵盖了一维、二维及多维数组的声明、初始化、访问与遍历方法,以及Arrays类的常用操作,对Java数组与集合相... 目录一、Java数组基础1.1 数组结构概述1.2 一维数组1.2.1 声明与初始化1.2.2 访问

Javaee多线程之进程和线程之间的区别和联系(最新整理)

《Javaee多线程之进程和线程之间的区别和联系(最新整理)》进程是资源分配单位,线程是调度执行单位,共享资源更高效,创建线程五种方式:继承Thread、Runnable接口、匿名类、lambda,r... 目录进程和线程进程线程进程和线程的区别创建线程的五种写法继承Thread,重写run实现Runnab

Java 方法重载Overload常见误区及注意事项

《Java方法重载Overload常见误区及注意事项》Java方法重载允许同一类中同名方法通过参数类型、数量、顺序差异实现功能扩展,提升代码灵活性,核心条件为参数列表不同,不涉及返回类型、访问修饰符... 目录Java 方法重载(Overload)详解一、方法重载的核心条件二、构成方法重载的具体情况三、不构

Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

《Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式》本文详细介绍如何使用Java通过JDBC连接MySQL数据库,包括下载驱动、配置Eclipse环境、检测数据库连接等关键步骤,... 目录一、下载驱动包二、放jar包三、检测数据库连接JavaJava 如何使用 JDBC 连接 mys

SpringBoot线程池配置使用示例详解

《SpringBoot线程池配置使用示例详解》SpringBoot集成@Async注解,支持线程池参数配置(核心数、队列容量、拒绝策略等)及生命周期管理,结合监控与任务装饰器,提升异步处理效率与系统... 目录一、核心特性二、添加依赖三、参数详解四、配置线程池五、应用实践代码说明拒绝策略(Rejected

一文详解SpringBoot中控制器的动态注册与卸载

《一文详解SpringBoot中控制器的动态注册与卸载》在项目开发中,通过动态注册和卸载控制器功能,可以根据业务场景和项目需要实现功能的动态增加、删除,提高系统的灵活性和可扩展性,下面我们就来看看Sp... 目录项目结构1. 创建 Spring Boot 启动类2. 创建一个测试控制器3. 创建动态控制器注

Java操作Word文档的全面指南

《Java操作Word文档的全面指南》在Java开发中,操作Word文档是常见的业务需求,广泛应用于合同生成、报表输出、通知发布、法律文书生成、病历模板填写等场景,本文将全面介绍Java操作Word文... 目录简介段落页头与页脚页码表格图片批注文本框目录图表简介Word编程最重要的类是org.apach

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP