SpringBoot配置文件优先级怎么排?properties和yml哪个更优?

 更新时间:2026年07月18日 15:00:23   作者:艾伦~耶格尔  
还在纠结SpringBoot配置文件用properties还是yml?这篇文章为你拆解它们的区别、优先级和多环境配置技巧,帮你高效管理应用设置,提升开发效率

Spring Boot 的强大之处在于其高度可配置性,允许开发者根据不同环境和需求定制应用程序的行为。而这一切的核心便是配置文件。

Spring Boot 支持多种配置文件格式,其中最常用的三种是 .properties、.yml 和 .yaml。

1. .properties:传统方式

.properties 文件是 Java 的传统配置文件格式,采用键值对结构,简单易懂。虽然语法简单,但对于复杂的配置结构,容易显得冗长且难以维护。

# 服务器配置
server.port=8080
server.servlet.context-path=/myapp
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 日志配置
logging.level.root=INFO
logging.file.name=myapp.log

2. .yml 和 .yaml:新兴方式

YAML (YAML Ain't Markup Language) 以其简洁、易读的特性,成为现代配置文件的宠儿。

.yml 和 .yaml 在 Spring Boot 中等效,都代表 YAML 格式。

YAML 使用缩进和冒号来表示层级关系,避免了 .properties 文件中大量的重复键名。

# 服务器配置
server:
  port: 8080
  servlet:
    context-path: /myapp
# 数据库配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: password
    driver-class-name: com.mysql.cj.jdbc.Driver
# 日志配置
logging:
  level:
    root: INFO
  file:
    name: myapp.log

YAML 的优势:

  • 简洁易读: 使用缩进代替括号,结构清晰,易于理解和维护。

  • 强大的表达能力: 支持列表、Map 等复杂数据结构,配置更加灵活。

  • 与其他语言兼容性好: YAML 被广泛用于各种编程语言和工具。

3. 配置文件优先级

Spring Boot 加载配置文件的优先级顺序至关重要,避免配置冲突,确保应用行为符合预期。

以下是从高到低的优先级顺序:

  • 命令行参数: --server.port=8081 (最高优先级)

  • Java 系统属性: -Dserver.port=8081

  • 操作系统环境变量

Jar 包外的配置文件:

  • config/application.properties (or .yml/.yaml)

  • application.properties (or .yml/.yaml)

Jar 包内的配置文件:

  • BOOT-INF/classes/config/application.properties (or .yml/.yaml)

  • BOOT-INF/classes/application.properties (or .yml/.yaml)

@PropertySource 注解: 通过 @PropertySource 注解加载的配置文件。

示例:优先级演示

假设 application.properties 中 server.port=8080,application-dev.yml 中 server.port=8081,命令行参数 --server.port=8082,激.活 dev profile。

最终端口号将是 8082,因为命令行参数优先级最高。

4. 多环境配置

Spring Boot 提供了强大的多环境配置机制,方便在不同环境(开发、测试、生产等)使用不同的配置。

  • 基于 Profile 的配置文件: application-{profile}.properties 或 application-{profile}.yml (例如:application-dev.yml, application-prod.yml)。

  • spring.profiles.active 属性: 在 application.properties 或 application.yml 中设置 spring.profiles.active 属性来激活特定的 profile。

# application.yml
spring:
  profiles:
    active: dev # 激活 dev profile

5. 示例

一般情况下,会有两个.yml文件,上边是以引用的方式声明,下边则是对应的属性值,这样写的好处是,能够对于配置信息一目了然,便于开发。

总结

Spring Boot 的配置文件机制灵活而强大,.properties、.yml 和 .yaml 提供了多种选择。理解它们的特性、优先级和多环境配置,并结合最佳实践,可以让你更好地管理应用配置,提高开发效率和代码质量。 

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • springboot项目同时启动web服务和grpc服务的方法

    springboot项目同时启动web服务和grpc服务的方法

    本文主要介绍了springboot项目同时启动web服务和grpc服务的方法,通过实际代码示例展示了实现,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-02-02
  • 一篇文章带你了解Java 中序列化与反序列化

    一篇文章带你了解Java 中序列化与反序列化

    这篇文章主要介绍了Java 序列化与反序列化(Serialization),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-07-07
  • 超详细的IntelliJ IDEA的安装及配置

    超详细的IntelliJ IDEA的安装及配置

    这篇文章主要介绍了超详细的IntelliJ IDEA的安装及配置,文中有非常详细的图文示例,对想要安装IDEA的小伙伴们有非常好的帮助,需要的朋友可以参考下
    2021-04-04
  • java之jvm加载器例举

    java之jvm加载器例举

    在本篇文章里小编给大家介绍了关于java之jvm加载器例举内容,对此有需要的程序员朋友们可以参考下。
    2021-03-03
  • SpringBoot整合WebSocket的客户端和服务端的实现代码

    SpringBoot整合WebSocket的客户端和服务端的实现代码

    这篇文章主要介绍了SpringBoot整合WebSocket的客户端和服务端的实现,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • java判定数组或集合是否存在某个元素的实例

    java判定数组或集合是否存在某个元素的实例

    下面小编就为大家带来一篇java判定数组或集合是否存在某个元素的实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • Java设计模式中组合模式应用详解

    Java设计模式中组合模式应用详解

    组合模式,又叫部分整体模式,它创建了对象组的数据结构组合模式使得用户对单个对象和组合对象的访问具有一致性。本文将通过示例为大家详细介绍一下组合模式,需要的可以参考一下
    2022-11-11
  • 微信开发协议小结

    微信开发协议小结

    通过本教程给大家分享微信开发协议小结的相关知识,非常不错,具有一定的参考借鉴价值,感兴趣的朋友一起看看吧
    2016-11-11
  • SpringBoot中@ComponentScan的使用详解

    SpringBoot中@ComponentScan的使用详解

    这篇文章主要介绍了SpringBoot中@ComponentScan的使用详解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-11-11
  • Java中Scanner用法实例解析

    Java中Scanner用法实例解析

    Scanner 指的是java.util包下的Scanner类,可以接收控制台输入的数据,下面这篇文章主要给大家介绍了关于Java中Scanner用法实例的相关资料,文中通过实例代码以及图文介绍的非常详细,需要的朋友可以参考下
    2022-11-11

最新评论