配置与 Profile

这一课你将能做到

1. 用 yml 组织项目配置，并用 @Value 和 @ConfigurationProperties 两种方式注入到代码
2. 建立 dev / prod 多环境配置，用三种方式（yml、命令行、环境变量）切换 Profile
3. 说清 Spring Boot 配置的优先级顺序，并用环境变量管理数据库密码等敏感信息

为什么要学

同一套代码，本地连 H2、测试连测试库、生产连生产库，端口、日志级别、第三方密钥全都不一样。配置与代码分离是后端工程的基本素养：代码管「怎么做」，配置管「用什么参数做」。

人话：application.yml 就是应用的「控制面板」。本站后端的数据库地址、Redis 密码、JWT 密钥全在这里管理，绝没有写死在代码里。这一课学的每个细节，上生产第一天就会用到。

先建立图像

application.yml            ← 所有环境共用的配置（应用名、通用行为）
application-dev.yml        ← 开发环境：H2 内存库、SQL 打印、日志 DEBUG
application-prod.yml       ← 生产环境：MySQL、日志 INFO、敏感信息用环境变量
        ↑
启动时通过 spring.profiles.active 指定激活哪个（可同时激活多个，后者覆盖前者）

优先级（高 → 低，记住前四层够用）：

命令行参数  >  环境变量  >  application-{profile}.yml  >  application.yml

规则一句话：越「靠近启动动作」的配置越优先，Profile 专属配置覆盖通用配置。

跟着做

步骤 1：写一份规范的 application.yml

覆盖 src/main/resources/application.yml：

spring:
  application:
    name: taskflow

server:
  port: 8080

# 自定义业务配置（约定以应用名开头，避免与框架键冲突）
taskflow:
  welcome: "欢迎来到任务管理平台"
  upload-dir: ./data/upload
  white-list:
    - 192.168.1.10
    - 10.0.0.5

yml 两条铁律：缩进用空格不用 Tab；同级键对齐，层级靠缩进表达。- 开头的行是列表元素。

步骤 2：@Value 读取（零散配置用）

写个临时 Controller 验证读取：

package com.example.taskflow.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
public class ConfigDemoController {

    @Value("${taskflow.welcome}")
    private String welcome;

    @Value("${taskflow.upload-dir}")
    private String uploadDir;

    @GetMapping("/api/config-demo")
    public String demo() {
        return welcome + " | 上传目录: " + uploadDir;
    }
}

启动后访问 http://localhost:8080/api/config-demo 即可看到注入结果。${taskflow.welcome:默认值} 的冒号写法还能提供兜底默认值。

步骤 3：@ConfigurationProperties 读取（成组配置用，推荐）

零散值用 @Value，。新建 ：