SpringBoot系列02yml与properties配置全解多环境profiles动态切换实战 专栏系列SpringBoot零基础进阶实战系列 文章难度入门进阶零基础可学企业级实战 核心目标彻底搞懂SpringBoot两大配置文件区别、加载优先级、多环境Profile动态切换解决开发/测试/生产环境配置切换痛点掌握企业级配置最佳实践 适用场景日常开发环境配置隔离、项目上线环境切换、多环境配置统一管理、配置优先级冲突排查一、前言为什么SpringBoot需要配置文件在传统SSM项目中我们需要编写大量XML配置文件配置繁琐、冗余且可读性差。SpringBoot核心特性之一就是自动化配置极大减少了手动配置同时提供了两套极简的配置方案application.properties和application.yml。所有项目常量、环境参数、数据库连接、服务器参数、第三方接口配置全部可以通过配置文件统一管理无需修改代码、无需重启项目部分配置即可实现参数修改。而在企业开发中开发、测试、生产三套环境配置隔离是刚需本文将从零讲解两种配置文件语法、核心区别、加载优先级手把手实现多环境Profile动态切换彻底解决环境配置混乱问题。二、SpringBoot两大配置文件详解SpringBoot项目默认支持两种配置格式功能完全等价均可实现项目所有配置仅语法、可读性、层级表现力有区别。2.1 properties配置文件传统键值对application.properties是SpringBoot默认的配置文件也是传统Java项目常用的配置格式语法简单、兼容性极强。2.1.1 基础语法规则语法格式keyvalue键值对形式一行一个配置注释格式以#开头层级表达通过.点分隔实现层级嵌套编码默认ISO-8859-1中文会乱码需要手动设置2.1.2 实战配置示例# 服务器基础配置 server.port8080 server.servlet.context-path/ # 项目名称、日志级别 spring.application.namespringboot-config-demo logging.level.com.exampleDEBUG # 数据库配置多层嵌套 spring.datasource.urljdbc:mysql://localhost:3306/test_db?useSSLfalseserverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.password123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver2.2 yml配置文件主流极简格式application.ymlYAML语言是目前企业开发首选配置格式以缩进式层级结构为主语法简洁、可读性极高完美适配SpringBoot分层配置思想。2.2.1 基础语法规则语法格式key: 空格 value冒号后必须加空格层级规则严格缩进统一2个空格禁止使用Tab注释格式以#开头编码默认UTF-8天然支持中文无乱码问题原生支持对象、数组、集合、Map等复杂数据结构2.2.2 实战配置示例# 服务器配置server:port:8080servlet:context-path:/# 项目配置spring:application:name:springboot-config-demo# 数据库配置层级清晰直观易懂datasource:url:jdbc:mysql://localhost:3306/test_db?useSSLfalseserverTimezoneAsia/Shanghaiusername:rootpassword:123456driver-class-name:com.mysql.cj.jdbc.Driver# 日志配置logging:level:com.example:DEBUG2.3 两种配置文件核心区别重点很多开发者只会用但不知道两种配置的优劣下表总结企业级选型核心差异对比维度propertiesyml语法结构扁平键值对通过点分隔层级缩进层级结构天然分层可读性多层配置冗余、冗长层级清晰一目了然数据结构支持仅支持简单键值对数组/对象表达繁琐原生支持数组、对象、Map、集合中文编码默认ISO-8859-1易乱码默认UTF-8完美支持中文特殊功能无支持单文件多文档块、锚点复用配置企业选型简单小型项目、老旧项目兼容中大型项目、微服务项目首选三、配置文件加载优先级高频面试实战坑点SpringBoot启动时会自动加载多个路径的配置文件优先级从高到低依次覆盖高优先级配置会覆盖低优先级同名配置这是90%配置失效、配置冲突的根源。3.1 配置文件加载路径优先级递减项目根目录/config目录最高优先级项目根目录resources/config目录resources目录默认配置存放位置最低优先级3.2 同目录下格式优先级同一目录下同时存在application.properties和application.yml时properties 优先级高于 yml同名配置会覆盖yml配置避坑提醒开发中建议只保留一种配置格式避免多格式配置冲突推荐统一使用yml。四、自定义配置绑定yml/properties通用除了SpringBoot内置配置我们日常开发需要自定义业务配置通过ConfigurationProperties实现配置与实体类绑定实现配置解耦。4.1 yml自定义配置# 自定义业务配置custom:project:springboot-demoversion:2.0.0author:技术博主# 数组配置server-list:-127.0.0.1-192.168.1.14.2 配置绑定实体类importlombok.Data;importorg.springframework.boot.context.properties.ConfigurationProperties;importorg.springframework.stereotype.Component;importjava.util.List;// 绑定自定义配置前缀ConfigurationProperties(prefixcustom)ComponentDatapublicclassCustomConfig{privateStringproject;privateStringversion;privateStringauthor;privateListStringserverList;}4.3 测试获取配置importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RestController;importjavax.annotation.Resource;RestControllerpublicclassConfigController{ResourceprivateCustomConfigcustomConfig;GetMapping(/getConfig)publicCustomConfiggetConfig(){returncustomConfig;}}启动项目访问接口即可成功读取yml自定义配置properties配置绑定方式完全一致。五、核心实战多环境Profiles动态切换企业开发标准环境划分dev开发环境、test测试环境、prod生产环境不同环境的端口、数据库、日志、接口地址完全不同手动修改配置极易出错SpringBoot Profile完美解决该问题。5.1 环境配置文件命名规范固定命名格式application-{环境标识}.yml公共配置application.yml所有环境通用配置开发环境application-dev.yml测试环境application-test.yml生产环境application-prod.yml加载规则公共配置 当前激活环境配置环境配置会覆盖公共配置同名参数5.2 分步搭建多环境配置第一步编写公共配置application.yml# 全局公共配置所有环境生效spring:application:name:springboot-profile-demo# 默认激活开发环境profiles:active:dev第二步编写开发环境配置application-dev.yml# 开发环境开启日志、本地数据库、自定义端口server:port:8080spring:datasource:url:jdbc:mysql://localhost:3306/dev_db?useSSLfalseserverTimezoneAsia/Shanghaiusername:rootpassword:123456logging:level:root:INFOcom.example:DEBUG第三步编写测试环境配置application-test.yml# 测试环境测试服务器数据库、端口8081server:port:8081spring:datasource:url:jdbc:mysql://192.168.1.100:3306/test_db?useSSLfalseserverTimezoneAsia/Shanghaiusername:testpassword:test123第四步编写生产环境配置application-prod.yml# 生产环境关闭调试日志、生产数据库、端口80server:port:80spring:datasource:url:jdbc:mysql://192.168.1.200:3306/prod_db?useSSLfalseserverTimezoneAsia/Shanghaiusername:prodpassword:Prod123456logging:level:root:WARNcom.example:WARN5.3 四种动态切换环境方式全覆盖方式1配置文件激活开发常用在公共配置application.yml中修改激活环境spring:profiles:active:test# 切换为 test / prod / dev方式2IDE启动参数激活本地调试常用IDEA 点击 Run - Edit Configurations - VM Options 输入-Dspring.profiles.activeprod优先级高于配置文件临时切换环境首选。方式3命令行参数激活服务器部署必备项目打包为jar包后服务器启动时动态指定环境无需修改代码和配置# 激活生产环境启动项目 java -jar springboot-demo.jar --spring.profiles.activeprod企业生产首选运维部署无需改动项目源码。方式4代码注解激活极少用importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;SpringBootApplicationpublicclassConfigApplication{publicstaticvoidmain(String[]args){// 手动指定激活环境System.setProperty(spring.profiles.active,dev);SpringApplication.run(ConfigApplication.class,args);}}5.4 特殊技巧yml单文件多环境配置yml支持---多文档块语法可将所有环境配置写在一个yml文件中适合小型项目# 公共配置spring:application:name:single-file-demo---# 开发环境spring:profiles:devserver:port:8080---# 测试环境spring:profiles:testserver:port:8081---# 生产环境spring:profiles:prodserver:port:80建议大型项目仍推荐多文件拆分结构更清晰、维护性更高。六、高频踩坑总结必看yml缩进坑必须2个空格缩进禁止Tab缩进错误直接启动报错yml空格坑key后冒号必须加空格如port: 8080无空格配置失效优先级坑同目录properties覆盖yml高路径配置覆盖低路径配置环境覆盖坑子环境配置会覆盖公共配置非完全替换未配置参数沿用公共配置中文乱码坑properties需手动设置编码为UTF-8yml无此问题配置绑定坑自定义配置绑定必须添加ConfigurationProperties注解且前缀对应准确七、企业级最佳实践统一配置格式项目全程使用yml摒弃properties统一规范、提升可读性严格环境拆分必须拆分dev/test/prod三套环境禁止一套配置跑所有环境公共配置抽离通用配置项目名、扫描路径放入公共yml环境独有配置放入子环境文件生产环境隔离生产环境关闭调试日志、弱化权限、开启安全配置禁止开启DEBUG日志部署动态切换服务器部署统一使用命令行指定环境灵活适配不同服务器禁止硬编码所有变量、端口、地址、密钥全部写入配置文件代码零硬编码八、总结本文全方位讲解了SpringBoot两大核心配置文件核心要点回顾1、properties简洁兼容yml层级清晰、功能更强企业开发首选yml2、SpringBoot配置有严格的加载优先级高优先级配置覆盖低优先级配置3、Profile多环境配置是企业开发刚需支持四种动态切换方式适配开发、测试、部署全场景4、遵循配置最佳实践可彻底解决环境配置混乱、切换出错、硬编码等常见问题。下一篇SpringBoot配置加密、配置中心Nacos集成、动态配置实时刷新实战持续更新中九、往期推荐SpringBoot系列01一文读懂自动配置原理新手从零搭建第一个HelloWorld项目十、下期预告SpringBoot系列03核心注解深度剖析SpringBootApplication、Configuration完整源码解读码字不易点赞 收藏 关注持续更新高质量干货