配置文件详解：yml多环境、配置优先级、参数绑定

配置文件详解：yml多环境、配置优先级、参数绑定

配置文件就像是项目的"控制面板"，旋钮拧到哪，程序就怎么跑。拧错了，轻则乱码，重则线上事故。这篇把配置那点事儿一次说透。

一、properties vs yml对比

SpringBoot默认支持两种配置文件格式：.properties和.yml（YAML）。

1.1 格式对比

properties格式（扁平结构）：

server.port=8080 server.servlet.context-path=/api spring.datasource.url=jdbc:mysql://localhost:3306/test spring.datasource.username=root spring.datasource.password=123456

yml格式（树状层级）：

server:port:8080servlet:context-path:/apispring:datasource:url:jdbc:mysql://localhost:3306/testusername:rootpassword:123456

实际开发中yml是主流，本文也以yml为主。

二、yml基础语法

2.1 核心规则

• 缩进用空格，不用Tab（这是最容易踩的坑）
• 缩进层级表示从属关系，同级要对齐
• 键值对用冒号+空格分隔：key: value（冒号后面必须有空格）
• 大小写敏感

2.2 常见数据结构

键值对：

name:张三age:25

列表（数组）：

server:port:8080interests:-编程-游戏-睡觉

也可以行内写法：

interests:[编程,游戏,睡觉]

嵌套对象：

person:name:张三age:25address:city:北京street:朝阳区

三、多环境配置

3.1 为什么要多环境

开发用本地数据库，测试用测试库，生产用线上库。总不能每次发布手动改配置吧？多环境配置就是解决这个问题的。

3.2 配置文件拆分

src/main/resources/ ├── application.yml # 主配置，公共配置放这里 ├── application-dev.yml # 开发环境 ├── application-test.yml # 测试环境 └── application-prod.yml # 生产环境

application.yml（主配置）：

server:port:8080spring:profiles:active:dev# 激活dev环境

application-dev.yml：

spring:datasource:url:jdbc:mysql://localhost:3306/dev_dbusername:dev_userpassword:dev_passlogging:level:root:DEBUG

application-prod.yml：

server:port:80spring:datasource:url:jdbc:mysql://192.168.1.100:3306/prod_dbusername:prod_userpassword:复杂的密码logging:level:root:WARN

3.3 激活指定环境

方式一：配置文件中激活（如上spring.profiles.active: dev）

方式二：命令行参数激活（最常用）

java-jarmyapp.jar--spring.profiles.active=prod

方式三：环境变量激活

exportSPRING_PROFILES_ACTIVE=prodjava-jarmyapp.jar

四、配置优先级

SpringBoot配置来源非常多，优先级从高到低：

记忆口诀：外部 > 内部，命令行 > 文件，带profile > 不带profile。

实际开发中最常用的是：命令行参数覆盖yml文件配置，用于线上临时调整参数。

五、参数绑定方式

5.1 @Value注解

最简单直接的方式，适合少量参数：

@RestControllerpublicclassHelloController{@Value("${server.port}")privateintport;@Value("${app.name:默认应用名}")// 冒号后是默认值privateStringappName;}

5.2 @ConfigurationProperties

适合批量绑定，将一组配置映射到Java对象：

yml配置：

app:name:我的博客系统version:1.0.0author:黑漂技术佬

配置类：

@Component@ConfigurationProperties(prefix="app")@Data// Lombok注解，自动生成getter/setterpublicclassAppProperties{privateStringname;privateStringversion;privateStringauthor;}

使用时直接注入：

@AutowiredprivateAppPropertiesappProperties;

5.3 @Value vs @ConfigurationProperties对比

松散绑定示例：yml里写app-name、app_name、appName都能绑定到appName字段。

5.4 配置类加JSR303校验

@Component@ConfigurationProperties(prefix="app")@Data@Validated// 开启校验publicclassAppProperties{@NotBlank(message="应用名不能为空")privateStringname;@Pattern(regexp="^\\d+\\.\\d+\\.\\d+$",message="版本号格式应为x.x.x")privateStringversion;@Email(message="邮箱格式不对")privateStringemail;}

配置不合法时项目启动直接报错，把问题拦在启动阶段。

六、常见yml配置陷阱

6.1 缩进错误

# 错误：Tab和空格混用spring:\tdatasource:url:xxx

yml不允许Tab缩进，一律用空格。IDEA里设置"将Tab转为空格"可以根治这个问题。

6.2 中文乱码

properties文件默认用ISO-8859-1编码，写中文必乱码。yml默认UTF-8没这个问题。

如果必须用properties，IDEA设置：

Settings → Editor → File Encodings → Default encoding for properties files: UTF-8

同时勾选"Transparent native-to-ascii conversion"。

6.3 引号问题

# 字符串一般不需要引号name:张三# 但包含特殊字符时需要引号description:"hello: world"# 包含冒号，用引号password:'123456'# 纯数字想当字符串，用引号# 双引号会转义，单引号不转义path1:"D:\new\folder"# \n会被当成换行path2:'D:\new\folder'# 原样输出

6.4 布尔值陷阱

# 下面两个含义不同enabled:true# 布尔值trueenabled:"true"# 字符串"true"

yml有类型推断，true/false/yes/no会被识别为布尔值。绑定到String字段时如果不想被转类型，加引号。