Spring Boot 配置全攻略：properties vs. YAML vs. 环境变量（超详细版）

大家好呀！👋 今天咱们来聊聊 Spring Boot 中一个超级重要但又经常让人迷糊的话题 —— 外部化配置！🤔 作为一个 Java 开发者，配置管理是我们每天都要打交道的事情，但你真的了解 Spring Boot 提供的各种配置方式吗？properties、YAML、环境变量…到底该用哪个？怎么用？别急，今天我就用最通俗易懂的方式，带你彻底搞懂它们！🚀

这篇文章会非常详细（超过3000字哦），但保证你看完就能成为配置小能手！💪 咱们先来个目录导航：

• 🏠 第一章：为什么要外部化配置？
• 📝 第二章：properties 配置详解
• 🎨 第三章：YAML 配置详解
• 🌍 第四章：环境变量配置详解
• 🔄 第五章：配置优先级大比拼
• 🏆 第六章：实战场景推荐
• 💡 第七章：高级技巧与小贴士

准备好了吗？Let’s go! 🎉

---

🏠 第一章：为什么要外部化配置？

首先，咱们得明白一个道理：代码是死的，配置是活的！🤓

想象你在开发一个电商网站🛒，本地测试时数据库连接的是你的笔记本，但上线后要连公司的服务器。如果数据库地址直接写在代码里，每次切换环境就得改代码、重新编译打包…太麻烦了吧！😫

这就是外部化配置存在的意义 —— 把可能变化的东西（数据库连接、服务地址、开关标志等）从代码中抽出来，放在外面单独管理。这样：

1. 环境隔离：不同环境（开发/测试/生产）用不同配置
2. 灵活修改：改配置不用重新编译代码
3. 安全保密：敏感信息不暴露在代码中

Spring Boot 提供了超多配置方式，今天咱们重点聊三种最常用的：properties、YAML 和环境变量。它们各有特点，适合不同场景。👇

---

📝 第二章：properties 配置详解

2.1 什么是 properties 文件？

properties 是 Java 界的老前辈了👴，格式超级简单：

# 应用配置
app.name=我的SpringBoot应用
app.version=1.0.0

# 数据库配置
db.url=jdbc:mysql://localhost:3306/test
db.username=root
db.password=123456

特点就是：键=值，一行一个配置，#号开头的是注释。

2.2 如何在 Spring Boot 中使用？

Spring Boot 默认会加载这些位置的 application.properties 文件：

1. 当前目录的 /config 子目录
2. 当前目录
3. classpath 下的 /config 包
4. classpath 根目录

加载顺序就是 1→2→3→4，后面的不会覆盖前面的相同配置。

2.3 实际例子

假设我们要配置服务器端口和数据源：

# 服务器配置
server.port=8080
server.servlet.context-path=/api

# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=admin
spring.datasource.password=secret
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

2.4 properties 的优点

• ✅ 简单直观：键值对形式，学习成本低
• ✅ 兼容性好：所有 Java 项目都能用
• ✅ 工具支持完善：IDE 都能智能提示

2.5 properties 的缺点

• ❌ 不支持层级结构：配置复杂时显得很扁平
• ❌ 重复前缀多：比如 spring.datasource.xxx 要写很多遍
• ❌ 不支持复杂数据类型：比如数组、列表

---

🎨 第三章：YAML 配置详解

3.1 什么是 YAML？

YAML（发音"亚麻尔"）是比 properties 更现代的结构化格式👶，全称是 “YAML Ain’t Markup Language”（递归缩写，程序员就爱玩这种梗😆）。

它长这样：

app:
  name: 我的SpringBoot应用
  version: 1.0.0

db:
  url: jdbc:mysql://localhost:3306/test
  username: root
  password: 123456

看出来了吗？用缩进表示层级关系，比 properties 更结构化！

3.2 YAML 的优势场景

YAML 特别适合：

1. 复杂配置：比如有嵌套结构的配置
2. 多环境配置：可以用 --- 分隔多个配置块
3. 需要可读性：比 properties 更易读

3.3 实际例子

同样的服务器和数据源配置，用 YAML 写：

server:
  port: 8080
  servlet:
    context-path: /api

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: admin
    password: secret
    driver-class-name: com.mysql.cj.jdbc.Driver

是不是层次更清晰？👀

3.4 YAML 的特殊语法

3.4.1 数组/列表

# 普通数组
features:
  - 登录
  - 注册
  - 支付

# 对象数组
users:
  - name: 张三
    age: 25
  - name: 李四
    age: 30

3.4.2 多环境配置

# 公共配置
common:
  app-name: 我的应用

---
# 开发环境
spring:
  profiles: dev
server:
  port: 8080

---
# 生产环境
spring:
  profiles: prod
server:
  port: 80

启动时用 --spring.profiles.active=dev 指定环境。

3.5 YAML 的优点

• ✅ 结构化：用缩进表示层级，更清晰
• ✅ 支持复杂类型：数组、列表、对象等
• ✅ 减少重复：相同前缀不用反复写
• ✅ 多文档支持：一个文件包含多个配置

3.6 YAML 的缺点

• ❌ 缩进敏感：缩进错了整个配置就废了
• ❌ 兼容性稍差：不是所有系统都支持
• ❌ 简单场景杀鸡用牛刀：小项目可能不需要

---

🌍 第四章：环境变量配置详解

4.1 什么是环境变量？

环境变量是操作系统提供的全局变量🌐，比如：

• Windows：set JAVA_HOME=C:\Program Files\Java
• Linux/Mac：export JAVA_HOME=/usr/lib/jvm

在 Spring Boot 中，环境变量可以这样用：

# 设置环境变量
export SERVER_PORT=9090
export SPRING_DATASOURCE_URL=jdbc:mysql://prod-db:3306/mydb

# 启动应用
java -jar myapp.jar

4.2 环境变量的命名规则

Spring Boot 对环境变量名有特殊处理：

1. 全大写
2. 点(.)换成下划线(_)
3. 减号(-)也换成下划线(_)

例如：

• server.port → SERVER_PORT
• spring.datasource.url → SPRING_DATASOURCE_URL

4.3 为什么用环境变量？

1. 安全：敏感信息不写在文件中
2. 容器友好：Docker/K8s 主要用环境变量
3. 动态性强：运行时可以修改

4.4 实际例子

假设我们要用环境变量配置数据库：

# 设置环境变量
export DB_URL=jdbc:mysql://prod-server:3306/mydb
export DB_USER=admin
export DB_PASS=s3cr3t

# 然后在 application.properties 中引用
spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}

或者直接在代码中获取：

@Value("${DB_URL}")
private String dbUrl;

4.5 环境变量的优点

• ✅ 最高优先级：可以覆盖其他配置
• ✅ 安全：不留在代码或文件中
• ✅ 云原生：适合 Docker/K8s 环境

4.6 环境变量的缺点

• ❌ 可读性差：大量配置时难以管理
• ❌ 修改需要重启：部分环境变量修改后需重启应用
• ❌ 不支持复杂结构：只适合简单键值对

---

🔄 第五章：配置优先级大比拼

Spring Boot 的配置源有很多，它们的优先级如下（从高到低）：

1. 命令行参数：java -jar app.jar --server.port=9090
2. JNDI 属性（现在很少用了）
3. Java 系统属性：System.getProperties()
4. 操作系统环境变量：就是我们刚讲的
5. 随机属性：random.* 开头的属性
6. 应用外部的配置文件：application-{profile}.properties/yaml
7. 应用内部的配置文件：打包在 jar 内的配置文件
8. @PropertySource 注解：代码中指定的配置文件
9. 默认属性：SpringApplication.setDefaultProperties

记忆口诀：命令行的权力最大，环境变量是二当家，文件配置是小弟，代码注解是临时工。👮

---

🏆 第六章：实战场景推荐

根据不同的使用场景，我推荐这样选择：

6.1 本地开发

推荐：YAML + 多环境配置

# application.yml
spring:
  profiles:
    active: dev

---
# 开发环境
spring:
  profiles: dev
server:
  port: 8080

---
# 测试环境
spring:
  profiles: test
server:
  port: 8081

6.2 生产部署

推荐：环境变量 + 外部 properties

# 生产环境启动命令
java -jar app.jar \
  --spring.config.location=file:/etc/myapp/application-prod.properties

6.3 云原生/K8s

推荐：ConfigMap + 环境变量

# K8s Deployment 示例
apiVersion: apps/v1
kind: Deployment
spec:
  containers:
  - name: app
    env:
    - name: DB_URL
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: database.url

6.4 敏感信息

一定要用：Vault/密钥管理服务 + 环境变量

永远不要把密码直接写在配置文件中！🚫

---

💡 第七章：高级技巧与小贴士

7.1 配置加密

敏感信息应该加密，可以用 Jasypt：

# 加密后的配置
spring.datasource.password=ENC(加密后的字符串)

启动时传入密钥：

java -jar app.jar --jasypt.encryptor.password=mysecretkey

7.2 配置验证

用 @ConfigurationProperties 验证配置：

@ConfigurationProperties(prefix = "app")
@Validated
public class AppConfig {
    @NotEmpty
    private String name;
    
    @Min(1)
    @Max(100)
    private int threads;
    // getters/setters
}

7.3 动态刷新

用 @RefreshScope 实现配置热更新（需要 Spring Cloud）：

@RestController
@RefreshScope
public class MyController {
    @Value("${message}")
    private String message;
    //...
}

7.4 最佳实践

1. 分环境配置：dev/test/prod 分开
2. 关键配置有默认值：避免启动失败
3. 敏感信息外部化：密码、密钥等
4. 文档化配置：团队共享配置含义
5. 版本控制：配置文件也要纳入 Git（敏感信息除外）

---

🎉 总结

来回顾一下今天的重点：

• properties：简单直接，适合小项目
• YAML：结构清晰，适合复杂配置
• 环境变量：安全灵活，适合生产环境

记住一个原则：根据场景选择合适的配置方式，没有银弹！ 🎯

配置管理看似简单，实则是项目健壮性的基石。希望这篇长文能帮你理清思路，如果觉得有用，别忘了点赞收藏哦！❤️ 有什么问题欢迎在评论区交流～

下次见！👋 🚀

推荐阅读文章

• 由 Spring 静态注入引发的一个线上T0级别事故（真的以后得避坑）

• 如何理解 HTTP 是无状态的，以及它与 Cookie 和 Session 之间的联系

• HTTP、HTTPS、Cookie 和 Session 之间的关系

• 什么是 Cookie？简单介绍与使用方法

• 什么是 Session？如何应用？

• 使用 Spring 框架构建 MVC 应用程序：初学者教程

• 有缺陷的 Java 代码：Java 开发人员最常犯的 10 大错误

• 如何理解应用 Java 多线程与并发编程？

• 把握Java泛型的艺术：协变、逆变与不可变性一网打尽

• Java Spring 中常用的 @PostConstruct 注解使用总结

• 如何理解线程安全这个概念？

• 理解 Java 桥接方法

• Spring 整合嵌入式 Tomcat 容器

• Tomcat 如何加载 SpringMVC 组件

• “在什么情况下类需要实现 Serializable，什么情况下又不需要（一）？”

• “避免序列化灾难：掌握实现 Serializable 的真相！（二）”

• 如何自定义一个自己的 Spring Boot Starter 组件（从入门到实践）

• 解密 Redis：如何通过 IO 多路复用征服高并发挑战！

• 线程 vs 虚拟线程：深入理解及区别

• 深度解读 JDK 8、JDK 11、JDK 17 和 JDK 21 的区别

• 10大程序员提升代码优雅度的必杀技，瞬间让你成为团队宠儿！

• “打破重复代码的魔咒：使用 Function 接口在 Java 8 中实现优雅重构！”

• Java 中消除 If-else 技巧总结

• 线程池的核心参数配置(仅供参考)

• 【人工智能】聊聊Transformer，深度学习的一股清流(13)

• Java 枚举的几个常用技巧，你可以试着用用

• 由 Spring 静态注入引发的一个线上T0级别事故（真的以后得避坑）

• 如何理解 HTTP 是无状态的，以及它与 Cookie 和 Session 之间的联系

• HTTP、HTTPS、Cookie 和 Session 之间的关系

• 使用 Spring 框架构建 MVC 应用程序：初学者教程

• 有缺陷的 Java 代码：Java 开发人员最常犯的 10 大错误

• Java Spring 中常用的 @PostConstruct 注解使用总结

• 线程 vs 虚拟线程：深入理解及区别

• 深度解读 JDK 8、JDK 11、JDK 17 和 JDK 21 的区别

• 10大程序员提升代码优雅度的必杀技，瞬间让你成为团队宠儿！

• 探索 Lombok 的 @Builder 和 @SuperBuilder：避坑指南（一）

• 为什么用了 @Builder 反而报错？深入理解 Lombok 的“暗坑”与解决方案（二）