SpringBoot 配置文件核心用法（Properties & YAML）

访问 /key 接口时，会返回配置文件中对应的值。这种方式适合读取少量独立配置项。

Bean 初始化时机补充

有时候我们需要在 Bean 创建完成且依赖注入结束后执行一些初始化逻辑，比如加载缓存或连接外部服务。这时可以使用 @PostConstruct 注解。

import javax.annotation.PostConstruct;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class UserService {
    @Autowired
    private ConfigService configService;

    // 依赖注入完成后自动执行
    @PostConstruct
    public void init() {
        String config = configService.getConfig();
        System.out.println("Bean 初始化完成，加载配置：" + config);
    }
}

注意标注的方法必须无参数、无返回值且非静态。它会在 @Autowired 之后执行，确保依赖对象已经就绪。

YAML 的树形结构与优势

YAML 是一种树形结构的配置语言，相比 Properties，它的可读性更强，尤其适合表达复杂的嵌套关系。

基础语法

YAML 的核心是 key: value，冒号后面必须跟一个空格。层级通过缩进来表示。

# 正确写法
server:
  port: 9090
  host: localhost

# 错误写法（缺少空格无法解析）
# server:port:9090

数据类型支持

YAML 原生支持多种数据类型，不需要像 Properties 那样做类型转换。

# 字符串（特殊字符需加引号）
name: 张三
remark: 'hello\nworld' # 单引号转义，\n 不会换行

# 数字与布尔值
age: 20
enabled: true

# 空值
empty: null

# 日期
birthday: 2024-03-18

集合与对象

对于数组或列表，YAML 提供了两种写法：短横线列表或方括号简写。

user:
  hobbies:
    - 篮球
    - 游泳
    - 编程
  tags: [Java, SpringBoot, MySQL]

当配置涉及复杂对象时，YAML 的结构非常清晰：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/test
    username: root
    password: 123456

读取复杂配置

虽然 @Value 也能读取简单属性，但面对对象或集合时，推荐使用 @ConfigurationProperties 进行批量绑定。

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Data
@Component
@ConfigurationProperties(prefix = "student")
public class Student {
    private int id;
    private String name;
    private int age;
}

配合如下 YAML 配置：

student:
  id: 1
  name: Java
  age: 18

在 Controller 中注入 Student 对象即可直接使用，无需手动映射字段。

最佳实践建议

1. 统一格式：尽量只保留一种配置文件格式，降低维护成本。
2. 注意编码：编辑 YML 文件时务必使用 UTF-8 编码，防止中文乱码。
3. 敏感信息：数据库密码等敏感配置建议放入环境变量或通过加密工具处理，不要硬编码在代码库中。
4. 注释规范：YAML 仅支持单行注释（#），多行说明建议写在文档或 README 中。

掌握这两种配置方式，能让我们更高效地管理 SpringBoot 项目的运行环境。