Spring Boot 配置体系详解

Spring Boot 配置体系知详解

定位：第 04 篇，讲透配置文件格式、加载位置与优先级顺序、类型安全绑定、松散绑定与外部化配置

适用版本：Spring Boot 3.x（JDK 17+）

---

目录

• 一、配置文件格式
• 二、加载位置与顺序
• 三、类型安全绑定
• 四、外部化与动态配置
• 五、总结
• 六、常见高频面试题

---

一、配置文件格式

1.1 两种格式

格式	特点	适用
application.properties	扁平键值对	简单、脚本生成友好
application.yml	层级结构、可读性好	复杂嵌套配置（主流）

yml 注意：缩进用空格不能用 tab ；同一文件多文档用 --- 分隔（常配合 profile）。

1.2 yml 的 profile 多文档

spring:
  datasource:
    url: jdbc:mysql://dev/db
---
spring:
  config:
    activate:
      on-profile: prod
  datasource:
    url: jdbc:mysql://prod/db

---

二、加载位置与顺序

2.1 属性来源优先级（高 → 低）

这是"配置为何生效/不生效"的总依据：

命令行参数（--server.port=9090）
  > Java 系统属性（-D）/ 操作系统环境变量
  > jar 外配置：./config/、./config/*/、./
  > jar 内：classpath:/config/、classpath:/
  > 默认值

要点：

• 外部配置覆盖内部：部署时无需重打包即可改配置（生产常用）；
• 命令行 > 一切：临时覆盖的最终手段。

2.2 同层规则

properties 优先于 yml（同位置同前缀时）
application-{profile}.yml 优先于 application.yml
后加载的属性源不覆盖先加载的（按优先级先到先得）

2.3 指定配置文件

--spring.config.location=/opt/app/config.yml    # 替换默认位置
--spring.config.additional-location=...         # 追加位置
--spring.config.name=app                        # 换文件名

---

三、类型安全绑定

3.1 @ConfigurationProperties 用法

@ConfigurationProperties(prefix = "app.mail")
@Validated                          // 开启校验
public class MailProperties {
    @NotBlank private String host;
    private int port = 25;          // 默认值
    private List<String> cc;        // 支持集合/嵌套对象
}

注册生效的两种方式：

① @EnableConfigurationProperties(MailProperties.class) 放配置类上
② @ConfigurationPropertiesScan 扫描（放启动类）
③ 属性类本身标 @Component（较少用）

3.2 松散绑定（Relaxed Binding）

配置键与属性名风格宽松匹配：

app.mail.max-connection   (kebab，配置文件推荐)
app.mail.maxConnection    (驼峰)
app.mail.MAX_CONNECTION   (环境变量风格，大写+下划线)
        ↓ 都绑定到
maxConnection

纪律：配置文件用 kebab-case，Java 用驼峰 ，靠松散绑定衔接；注意 @Value 不支持松散绑定，这是它不如类型安全绑定之处。

3.3 绑定校验

@Validated + JSR-303 注解（@NotBlank/@Min）让非法配置启动即失败------把配置错误挡在最早期，而非运行时报 NPE。

3.4 不可变绑定

@ConfigurationProperties(prefix = "app.mail")
public record MailProperties(@NotBlank String host, int port) {}
// 或 @ConstructorBinding（构造器绑定）

构造器/record 绑定产出不可变对象，线程安全、无 setter 篡改风险，3.x 推荐。

---

四、外部化与动态配置

4.1 部署友好的注入方式

环境变量：SPRING_DATASOURCE_URL=...     ← 容器化首选
JVM 参数：-Dspring.datasource.url=...
命令行：  --spring.datasource.url=...

敏感配置（密码、密钥）不写进代码库，走环境变量 / 密钥管理 / 配置中心。

4.2 占位符与随机值

app.secret=${random.uuid}
app.tmpdir=${java.io.tmpdir}
app.name=${OTHER_KEY:default}      ← 带默认值

4.3 配置中心与动态刷新

本地配置文件在启动时固化；运行期动态调整需配置中心（Spring Cloud Config / Nacos，CL 篇）：远端配置 + @RefreshScope 让 Bean 在配置变更时重建。

---

五、总结

1. 格式 ：properties 扁平、yml 层级；yml 用空格缩进，多文档用 --- 配 profile。
2. 优先级：命令行 > 系统属性/环境变量 > jar 外 > jar 内 > 默认；外部覆盖内部是部署友好设计；同位置 properties 覆盖 yml、profile 覆盖主配置。
3. 类型安全绑定：@ConfigurationProperties 前缀绑定 + 松散绑定 + @Validated 校验 + record/构造器不可变绑定，全面优于 @Value 堆。
4. 外部化：环境变量/参数注入敏感与易变配置；动态运行期变更交给配置中心 + @RefreshScope。

---

六、常见高频面试题

1. Spring Boot 配置文件的加载优先级？

要点：从高到低------命令行参数 > Java 系统属性/操作系统环境变量 > jar 包外部配置（./config/、./）> jar 内部（classpath:/config/、classpath:/）> 默认值。同位置 properties 优先于 yml；application-{profile} 优先于主配置。高优先级覆盖低优先级，外部配置覆盖打包内配置，使部署无需重新打包。排查"配置不生效"先看是否被更高优先级源覆盖。

2. yml 和 properties 怎么选？同层谁优先？

要点：yml 层级清晰、可读性好、支持多文档（--- 配 profile），适合复杂嵌套，是主流；properties 扁平，脚本生成友好。同一位置、同一前缀下两者都存在时，properties 的值优先于 yml。注意 yml 缩进必须用空格不能用 tab，否则解析报错。实践中通常选一种统一，避免两者混用造成覆盖关系混乱。

3. @ConfigurationProperties 和 @Value 的区别？

要点：@ConfigurationProperties 前缀批量绑定到 POJO：支持松散绑定（kebab/驼峰/大写下划线互认）、支持 @Validated 校验、支持复杂类型（List/Map/嵌套）、可生成元数据供 IDE 提示，适合一组结构化配置。@Value 注入单个值、支持 SpEL，但不支持松散绑定与批量校验。结构化配置优先 @ConfigurationProperties，零散单值用 @Value。

4. 什么是松散绑定？

要点：@ConfigurationProperties 绑定时，配置键与 Java 属性名在书写风格上宽松对应：kebab-case（max-connection）、驼峰（maxConnection）、大写下划线（MAX_CONNECTION，环境变量常用）都能绑定到同一字段。这让配置文件可用规范的连字符风格、环境变量可用大写风格，而 Java 侧保持驼峰。注意 @Value 不做松散绑定。

5. 如何在启动时校验配置合法性？

要点：配置属性类加 @Validated，字段用 JSR-303 注解（@NotBlank/@Min/@NotNull 等），Spring Boot 绑定时校验，不合法启动直接失败（快速失败），把配置错误挡在最早期而非运行期。配合默认值设计，必填项强制校验、可选项给默认。这比"启动成功但运行时 NPE"健壮得多。

6. 敏感配置（数据库密码等）怎么管理？

要点：不进代码库。手段按环境：本地开发用不提交的本地配置文件（加 .gitignore）或环境变量；部署环境用环境变量/启动参数注入（容器化首选）；生产用配置中心 + 加密或专门密钥管理服务。配置文件中可用占位符引用环境变量（${DB_PASSWORD}）。原则：代码库只存配置结构，不存敏感值。

7. 如何让配置在运行期动态生效？

要点：本地配置启动时固化，动态变更需配置中心。接入 Spring Cloud Config / Nacos 等，配置存远端；需要动态刷新的 Bean 标 @RefreshScope，配置变更（配合 /actuator/refresh 或监听）时这些 Bean 被重建以加载新值。注意 @RefreshScope 重建有短暂代价，且单例持有的旧引用不会自动更新；非 @RefreshScope 的 Bean 不受影响。

8. jar 外部的配置如何覆盖内部？

要点：Spring Boot 默认在 jar 外的 ./config/、./config/*/、./ 等位置查找配置文件，且外部位置优先级高于 jar 内。部署时把修改后的 application.yml 放到这些目录（或用 --spring.config.location 指定）即可不重打包覆盖配置。机制是外部配置作为更高优先级的属性源加入 Environment。这是"配置与制品分离"的部署基础。

9. --spring.config.location 和 --spring.config.additional-location 的区别？

要点：spring.config.location 会替换默认配置文件位置（只用指定的）；spring.config.additional-location 在默认位置之外追加查找位置（默认仍生效，追加的优先级更高可覆盖）。换文件名用 spring.config.name。多位置/多文件时仍遵循属性源优先级规则。常用于把配置集中到统一目录管理。

10. 什么是构造器绑定/record 绑定？有什么好处？

要点：@ConfigurationProperties 支持通过构造器（或 Java record）绑定，而非 setter。好处：绑定产物是不可变对象------无 setter 不能被运行期篡改，天然线程安全，符合值对象语义；配合 record 代码极简。3.x 推荐这种不可变绑定方式；需要可变或框架反射填充的传统场景仍可用 setter 方式。