一、前言在 SpringBoot 开发中配置文件是项目核心基础设施所有端口、数据库、中间件、自定义业务参数都依赖配置文件实现解耦。SpringBoot 提供两套主流配置文件application.properties、application.yml (yaml)。很多初学者只会简单写配置不懂加载优先级、多环境机制、配置覆盖规则、读取方式区别导致频繁出现端口配置不生效多环境切换冲突配置占位符报错数据库自动配置启动报错List/Map/ 嵌套对象无法绑定本文从零系统化讲解 SpringBoot 全部配置体系涵盖语法、区别、多环境、加载优先级、读取注解、变量引用、外部配置、实战报错解决可直接作为学习与面试手册。二、两种配置文件语法详解与对比1. properties 传统键值配置默认兼容核心语法规则格式keyvalue层级嵌套通过。无限拼接注释# 单行注释所有值默认字符串类型不会自动类型推断数组通过下标 [0]、[1] 赋值完整示例properties# 服务基础配置 server.port8086 # 普通字段 person.lastnamezhangsan person.age18 person.bossfalse person.birth2017-12-12 # Map集合 person.maps.k1V1 person.maps.k212 # List数组 person.lists[0]lisi person.lists[1]zhaoliu # 嵌套对象 person.dog.namedaoge person.dog.age122. yml 分层配置核心语法规则层级依靠 2 个空格缩进绝对不能用 Tab冒号后面必须带一个空格自动识别数据类型数字、布尔、日期、集合数组使用 - 符号定义支持 --- 多文档分段实现单文件多环境完整示例yamlserver: port: 8086 person: lastname: zhangsan age: 18 boss: false birth: 2017-12-12 maps: k1: V1 k2: 12 lists: - lisi - zhaoliu dog: name: daoge age: 123. properties VS yml 核心区别表格对比维度propertiesyml层级表达点拼接嵌套多了极其冗长缩进分层结构清晰数据类型全部视为字符串自动识别数字、布尔、日期、集合数组写法下标索引繁琐横杠遍历简洁直观多环境支持不支持单文件分段支持 --- 切分多环境同级优先级更高同目录下 properties 覆盖 yml低于 properties可读性复杂配置极差复杂配置首选企业规范统一使用 yml 作为主配置文件三、SpringBoot 完整配置加载优先级SpringBoot 配置遵循高优先级覆盖低优先级全部加载、同名覆盖。下面是从最高优先级 → 最低优先级完整排序。1. 顶级优先级命令行参数最高java -jar demo.jar --server.port9090直接在虚拟机参数这里设计Java 系统属性-Dserver.port9090操作系统环境变量系统 / 容器环境变量2. 外部配置文件Jar 包同级目录优先级高于项目内部配置适合线上运维改配置无需重打包。file:./config/ Jar 同级 config 文件夹配置file:./ Jar 同级目录配置文件3. 项目内部配置文件classpath:/config/resources/config 目录classpath:/resources 根目录日常主配置4. 环境配置覆盖规则激活某个 profile 时application-{profile}.yml 覆盖 application.yml 同名配置公共配置放主文件环境差异放环境文件。5. 自定义配置文件最低通过 PropertySource 加载的自定义 properties优先级最低会被所有 application 系列配置覆盖。优先级总结口诀命令行 系统变量 外部配置 内部环境配置 内部主配置 自定义配置文件四、多环境配置示例dev/test/prod开发、测试、生产环境端口、数据库、日志配置不同SpringBoot 提供三种标准多环境方案。方案一单 yml 多分段适合小型项目通过 --- 分割配置段通过 spring.config.activate.on-profile 绑定环境。yaml# 默认全局配置所有环境共享 server: port: 8086 # 开发环境 --- server: port: 8077 spring: config: activate: on-profile: dev # 生产环境 --- server: port: 8085 spring: config: activate: on-profile: prod方案二多文件拆分resources 下创建多环境文件命名规范application-{profile}.ymlapplication.yml公共配置所有环境生效application-dev.yml开发环境application-prod.yml生产环境加载逻辑激活 dev 时公共配置 dev 配置合并dev 覆盖公共。方案三自定义外部配置文件自定义 Person.properties 等文件需要手动注解加载Spring 不会自动识别。javaComponent PropertySource(value classpath:Person.properties, encoding UTF-8) ConfigurationProperties(prefix person) public class Person { // 自动绑定自定义配置文件参数 }环境激活三种方式IDEA 启动配置Active profiles 填写 dev /prod可以直接运行相应的配置代码启动SpringApplication.run (Application.class, --spring.profiles.activedev)命令行启动java -jar demo.jar --spring.profiles.activeprod五、配置文件两种读取方式对比1. Value 单字段读取适合少量、零散、独立配置语法简单。javaComponent public class Person { // 读取配置支持默认值找不到配置用默认 Value(${person.lastname:defaultName}) private String lastname; Value(${person.age:18}) private Integer age; }缺点不支持 List、Map、嵌套对象字段多了代码冗余无自动类型批量绑定2. ConfigurationProperties 批量对象绑定推荐专门用于批量绑定、嵌套对象、集合类型适配所有复杂配置场景。完整实战代码javaData Component ConfigurationProperties(prefix person) public class Person { private String lastname; private Integer age; private Boolean boss; private ListString lists; private MapString, String maps; private Dog dog; } Data public class Dog { private String name; private Integer age; }启动类开启配置绑定javaSpringBootApplication EnableConfigurationProperties(Person.class) public class SpringBootDemoApplication { }两种注解选型规范少量零散配置用 Value批量、对象、集合、嵌套配置必须用 ConfigurationProperties六、配置变量引用与高级用法1. 内部配置互相引用yamlproject: name: springboot-demo info: desc: 项目名称${project.name} # 配置不存在给默认值 server: port: ${server.port:8080}2. Maven 变量注入pom 中定义版本yml 直接读取统一版本管理。 pom.xmlxmlproperties mysql.version9.7.0/mysql.version /propertiesyml 读取yamlmysql: version: mysql.version七、打包后外部配置最佳实践线上项目不推荐把配置全部打进 Jar修改配置需要重打包。推荐外部配置文件方式Jar 包同级新建 application-prod.yml启动时指定环境java -jar demo.jar --spring.profiles.activeprod外部配置自动覆盖 Jar 内部配置运维可直接改文件重启无需改代码八、总结统一使用 yml放弃 properties结构更优雅适配多环境多环境文件拆分application.yml dev/prod 拆分不使用单文件分段复杂配置用对象绑定全部使用 ConfigurationProperties放弃大量 Value测试环境排除数据源单纯测试配置、端口时exclude 数据源避免报错线上使用外部配置配置与代码解耦方便运维迭代公共配置抽主文件差异化配置放环境文件减少冗余九、结尾SpringBoot 配置看着简单但优先级、加载机制、绑定规则、多环境原理是进阶核心。掌握本文全部内容可以彻底解决 99% 的配置类报错同时适配企业开发规范也是面试高频考点。