一文搞懂Spring Boot 配置加载原理以及配置优先级

本文涉及的产品
云原生网关 MSE Higress,422元/月
服务治理 MSE Sentinel/OpenSergo,Agent数量 不受限
注册配置 MSE Nacos/ZooKeeper,118元/月
简介: 背景:最近有个开发同学问我,为什么他在配置文件里面配置了端口号但是一直不生效,我看了后发现在其他地方已经配置过端口号了,所以当前配置不生效,那么到底Spring Boot 是如何处理配置文件的呢,在配置项重复的情况下又是如何处理的呢
  • 👏作者简介:大家好,我是冰点,从业11年,目前在物流独角兽企业从事技术方面工作,
  • 🍂博主正在努力完成2023计划中:以梦为马,扬帆起航,2023追梦人
  • 📝联系方式:iceicepip,加我进群,大家一起学习,一起进步👀

@[TOC]

1. 前言

背景:最近有个开发同学问我,为什么他在配置文件里面配置了端口号但是一直不生效,我看了后发现在其他地方已经配置过端口号了,所以当前配置不生效,那么到底Spring Boot 是如何处理配置文件的呢,在配置项重复的情况下又是如何处理的呢

在Spring Boot中,可以使用.properties或.yml文件来配置应用程序属性。默认情况下,Spring Boot将首先查找application.properties或application.yml文件,如果没有找到,则会使用其他命名规则的文件,例如application-{profile}.properties或application-{profile}.yml,其中{profile}是激活的Spring配置文件。
其实在SpringBoot中我们不仅仅可以通过配置文件进行配置,也可以有以下这几种

  1. 命令行参数 可以使用--property=value语法在命令行中指定属性值。
  2. Java系统属性(System.getProperties())。
  3. 操作系统环境变量。

2. 结论

在这里插入图片描述

  1. 命令行参数 > 2. Java系统属性 >3. 操作系统环境变量>4.jar包外部的application>5.jar包内部的application- > 5.jar包外部的application.properties > 7.jar包内部的application.properties

根据结论我们先抛出几个问题
\==1. spring boot 在application.properties 和application.yml中如果有相同的配置项,谁的优先级更高呢==
\==2. 上面的结论里面为什么没有bootstrap.properties和bootstrap.yml。那么他的优先级是位于哪里呢?==

2. 配置文件的加载流程

2.1 确定需要加载哪些配置文件

Spring Boot默认会加载application.properties或application.yml文件,如果当前激活了某个profile,还会额外加载application-{profile}.properties或application-{profile}.yml文件。

例如,如果激活了"dev" profile,那么Spring Boot会加载application.properties和application-dev.properties两个文件,并将它们合并成一个属性集合。

2.1 加载配置文件

Spring Boot使用ResourceLoader接口来加载配置文件。ResourceLoader是一个抽象接口,它定义了一组方法,用于加载各种类型的资源,包括文件、URL、类路径等等。在Spring Boot中,通常使用ClasspathResourceLoader来加载配置文件。
配置文件的加载主要是这两个核心类。如果大家感兴趣可以点进去,就会发现,spring boot 不仅仅只支持.properties 和yml 后缀的配置文件。它同样也支持xml、yaml。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

2.1 排序配置文件

Spring Boot使用Ordered接口来排序配置文件,以确保它们被正确地解析和合并。每个配置文件都可以实现Ordered接口来指定它们的优先级。Spring Boot默认会按照以下顺序排序配置文件:
bootstrap.properties
application.properties
application.yml
application-{profile}.properties
application-{profile}.yml
其中,application.properties和application.yml的优先级最低,而激活的profile相关的配置文件的优先级最高。

  1. bootstrap.properties:如果存在bootstrap.properties文件,则其中的属性将具有比其他属性文件更高的优先级。主要用于配置SpringCloud Config Server连接属性等。
  2. application.properties:如果存在则其中的属性将被加载,并覆盖与之相同的属性文件中的属性。
  3. application.yml:如果存在application.yml文件,则其中的属性将被加载,并覆盖与之相同的属性文件中的属性。
  4. application-{profile}.properties:Spring Boot会根据当前激活的配置文件加载与之对应的属性文件。例如,如果激活了dev配置文件,则会加载application-dev.properties文件。如果存在application-{profile}.properties文件,则其中的属性将被加载,并覆盖与之相同的属性文件中的属性。
  5. application-{profile}.yml:如果存在application-{profile}.yml文件,则其中的属性将被加载,并覆盖与之相同的属性文件中的属性。如果同时存在application-{profile}.properties和application-{profile}.yml文件,则以.properties文件为准。

如果存在多个属性文件中具有相同的属性,则具有最高优先级的属性将覆盖其他属性。例如,如果在application.properties文件和application-dev.properties文件中都定义了server.port属性,则application-dev.properties文件中定义的属性将覆盖application.properties文件中的属性。同样,如果在application.yml和application-dev.yml文件中都定义了相同的属性,则application-dev.yml文件中定义的属性将覆盖application.yml文件中的属性

2.1 合并属性

在排序和加载完所有配置文件之后,Spring Boot将它们合并成一个统一的属性集合。如果有多个配置文件中都定义了相同的属性,则后加载的配置文件中的属性会覆盖之前加载的属性。

2.1 绑定属性到Java对象

最后,Spring Boot使用@ConfigurationProperties注解将属性集合绑定到Java对象上。这个注解告诉Spring Boot将属性集合中的属性自动绑定到Java对象的相应属性上。当Java对象被创建时,Spring Boot会自动将属性集合中的属性值注入到该对象的属性中。这使得开发人员可以轻松地访问和使用配置属性。

3. 核心源码解析

ConfigFileApplicationListener类(spring boot 2.4.0之后版本已经废弃,之后版本使用ConfigDataEnvironmentPostProcessor)是Spring Boot中负责加载应用程序配置文件并将其转换为统一属性集合的关键组件之一。该类监听了ApplicationEnvironmentPreparedEvent事件,当事件发生时,它会加载应用程序的配置文件,并将其合并为一个统一的属性集合。

在onApplicationEvent方法中,它首先判断事件类型,如果是ApplicationEnvironmentPreparedEvent事件,则调用onApplicationEnvironmentPreparedEvent方法进行处理。在onApplicationEnvironmentPreparedEvent方法中,它首先调用loadPostProcessors方法加载EnvironmentPostProcessor对象,并将ConfigFileApplicationListener自身添加到postProcessors列表中。然后,通过AnnotationAwareOrderComparator类对postProcessors列表进行排序,以保证EnvironmentPostProcessor对象按照指定的顺序执行。最后,遍历postProcessors列表,调用每个EnvironmentPostProcessor对象的postProcessEnvironment方法,将配置文件中的属性合并到Spring的Environment中。

\==可以参考代码注释理解==

@Override
public void onApplicationEvent(ApplicationEvent event) {
   
   
    // 如果是ApplicationEnvironmentPreparedEvent事件,则调用onApplicationEnvironmentPreparedEvent方法处理
    if (event instanceof ApplicationEnvironmentPreparedEvent) {
   
   
        onApplicationEnvironmentPreparedEvent((ApplicationEnvironmentPreparedEvent) event);
    }
    // 如果是ApplicationPreparedEvent事件,则调用onApplicationPreparedEvent方法处理
    if (event instanceof ApplicationPreparedEvent) {
   
   
        onApplicationPreparedEvent(event);
    }
}

private void onApplicationEnvironmentPreparedEvent(ApplicationEnvironmentPreparedEvent event) {
   
   
    // 加载EnvironmentPostProcessor对象,并将ConfigFileApplicationListener自身添加到postProcessors列表中
    List<EnvironmentPostProcessor> postProcessors = loadPostProcessors();
    postProcessors.add(this);
    // 对postProcessors列表进行排序,以保证EnvironmentPostProcessor对象按照指定的顺序执行
    AnnotationAwareOrderComparator.sort(postProcessors);
    // 遍历postProcessors列表,调用每个EnvironmentPostProcessor对象的postProcessEnvironment方法,将配置文件中的属性合并到Spring的Environment中
    for (EnvironmentPostProcessor postProcessor : postProcessors) {
   
   
        postProcessor.postProcessEnvironment(event.getEnvironment(), event.getSpringApplication());
    }
}

排序后,我们可以看到这块的一共有7个配置加载处理器。我们只关注配置文件的处理。此处我们也能看到如果引入了Apollo。Apollo配置处理器的加载顺序。
在这里插入图片描述
如果我们跟process的执行逻辑,其实最后都是走到了配置加载方法

public void load() {
   
   
    // 初始化profiles、processedProfiles、activatedProfiles和loaded等属性
    this.profiles = new LinkedList<>();
    this.processedProfiles = new LinkedList<>();
    this.activatedProfiles = false;
    this.loaded = new LinkedHashMap<>();
    // 初始化profiles属性,表示需要处理的配置文件的profile
    initializeProfiles();
    // 处理profiles属性中的各个profile
    while (!this.profiles.isEmpty()) {
   
   
        // 从profiles队列中取出一个Profile对象
        Profile profile = this.profiles.poll();
        // 如果profile不为空且不是默认profile,则将其添加到Environment中
        if (profile != null && !profile.isDefaultProfile()) {
   
   
            addProfileToEnvironment(profile.getName());
        }
        // 加载profile对应的配置文件
        load(profile, this::getPositiveProfileFilter,
                addToLoaded(MutablePropertySources::addLast, false));
        // 将processedProfiles属性中添加已处理的profile
        this.processedProfiles.add(profile);
    }
    // 加载不属于任何profile的配置文件
    load(null, this::getNegativeProfileFilter,
            addToLoaded(MutablePropertySources::addFirst, true));
    // 将loaded属性中的属性源添加到Environment中
    addLoadedPropertySources();
}

从ConfigFileApplicationListener中我们能够看到有哪些地方我们可以放配置文件。
在这里插入图片描述
上面的源码基本上能解决我们Spring Boot 是如何加载,解析配置文件的。但是解决不了我们这些配置项是如何绑定到对象的配置类(@Configration)的属性上的,或者如何注入到@Value 的注解修饰的属性上的。
由于篇幅有限,我大概抛转引玉,为大家抛砖引玉,解释一下关于Spring Boot 配置加载和解析,绑定相关的类。
和配置加载相关的类位于spring-boot包下

3.1 配置加载相关类

在这里插入图片描述

3.2 属性注入和绑定的源码

位于 org.springframework.boot.context.properties

在这里插入图片描述
我们可以看到有我们熟悉的,可能使用过的源码或注解
ConfigurationProperties:注解用于标记一个类,表示它是一个配置属性类,用于存储应用程序的配置信息。
ConfigurationPropertiesBinder:用于将配置属性绑定到 对象上。
ConfigurationPropertiesBindingPostProcessor 容器启动时用于处理带有@ConfigurationProperties注解的 Bean。

4.总结

所以我们通常遇到问题如果发现很奇怪无法解释,可能只需要翻翻官方文档,跟跟代码就可以解释了。此代码版本为2.0版本。其他版本会有差异,但是原理上都是大同小异的。再教给大家一个看官方文档的小技巧。比如我要看Spring Boot 2.0.3版本文档,只需要将URL 。https://docs.spring.io/spring-boot/docs/2.0.3.RELEASE/reference/htmlsingle/中的版本号改为自己当前项目的版本号即可。
或者干脆到Spring Boot 文档索引里面查看https://docs.spring.io/spring-boot/docs/

Spring boot 关于配置优先级的官方文档

好了,本次的分享就到这儿,我是冰点,下次见。如果我的文章对你有所收获,可以给个赞。如果有疑问可以在评论区留言。

目录
相关文章
|
1天前
|
Java Spring
【Spring】方法注解@Bean,配置类扫描路径
@Bean方法注解,如何在同一个类下面定义多个Bean对象,配置扫描路径
104 73
|
2天前
|
Java 数据库连接 Maven
最新版 | 深入剖析SpringBoot3源码——分析自动装配原理(面试常考)
自动装配是现在面试中常考的一道面试题。本文基于最新的 SpringBoot 3.3.3 版本的源码来分析自动装配的原理,并在文未说明了SpringBoot2和SpringBoot3的自动装配源码中区别,以及面试回答的拿分核心话术。
最新版 | 深入剖析SpringBoot3源码——分析自动装配原理(面试常考)
|
2天前
|
Java Maven Spring
SpringBoot配置跨模块扫描问题解决方案
在分布式项目中,使用Maven进行多模块开发时,某些模块(如xxx-common)没有启动类。如何将这些模块中的类注册为Spring管理的Bean对象?本文通过案例分析,介绍了两种解决方案:常规方案是通过`@SpringBootApplication(scanBasePackages)`指定扫描路径;推荐方案是保持各模块包结构一致(如com.xxx),利用SpringBoot默认扫描规则自动识别其他模块中的组件,简化配置。
SpringBoot配置跨模块扫描问题解决方案
|
1天前
|
Java Spring
【Spring配置相关】启动类为Current File,如何更改
问题场景:当我们切换类的界面的时候,重新启动的按钮是灰色的,不能使用,并且只有一个Current File 项目,下面介绍两种方法来解决这个问题。
|
1天前
|
Java Spring
【Spring配置】idea编码格式导致注解汉字无法保存
问题一:对于同一个项目,我们在使用idea的过程中,使用汉字注解完后,再打开该项目,汉字变成乱码问题二:本来a项目中,汉字注解调试好了,没有乱码了,但是创建出来的新的项目,写的注解又成乱码了。
|
1天前
|
Java Spring
【Spring配置】创建yml文件和properties或yml文件没有绿叶
本文主要针对,一个项目中怎么创建yml和properties两种不同文件,进行配置,和启动类没有绿叶标识进行解决。
|
9天前
|
NoSQL Java Redis
Spring Boot 自动配置机制:从原理到自定义
Spring Boot 的自动配置机制通过 `spring.factories` 文件和 `@EnableAutoConfiguration` 注解,根据类路径中的依赖和条件注解自动配置所需的 Bean,大大简化了开发过程。本文深入探讨了自动配置的原理、条件化配置、自定义自动配置以及实际应用案例,帮助开发者更好地理解和利用这一强大特性。
53 14
|
7天前
|
XML Java 数据格式
Spring容器Bean之XML配置方式
通过对以上内容的掌握,开发人员可以灵活地使用Spring的XML配置方式来管理应用程序的Bean,提高代码的模块化和可维护性。
36 6
|
8天前
|
XML Java 数据格式
🌱 深入Spring的心脏:Bean配置的艺术与实践 🌟
本文深入探讨了Spring框架中Bean配置的奥秘,从基本概念到XML配置文件的使用,再到静态工厂方式实例化Bean的详细步骤,通过实际代码示例帮助读者更好地理解和应用Spring的Bean配置。希望对你的Spring开发之旅有所助益。
55 3
|
2月前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 实现动态路由和菜单功能,快速搭建前后端分离的应用框架
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 实现动态路由和菜单功能,快速搭建前后端分离的应用框架。首先,确保开发环境已安装必要的工具,然后创建并配置 Spring Boot 项目,包括添加依赖和配置 Spring Security。接着,创建后端 API 和前端项目,配置动态路由和菜单。最后,运行项目并分享实践心得,包括版本兼容性、安全性、性能调优等方面。
186 1