spring boot 中推荐使用 @configurationproperties 将配置文件中的层级键值映射为 javabean，需配合 prefix、@component 及 setter 方法，支持嵌套、校验；@value 仅适用于简单单值绑定，不支持嵌套结构。

Spring Boot 中将自定义配置绑定到 JavaBean，核心是让配置文件（application.yml 或 application.properties）里的键值，自动映射为 Java 对象的字段。主流且推荐的方式是使用 @ConfigurationProperties，辅以 @Value 用于简单场景。

用 @ConfigurationProperties 绑定（推荐）

这是类型安全、支持嵌套结构、可校验、适合批量配置的首选方式。

• 在配置文件中定义层级结构，例如：
  app:
  name: demo-app
  timeout: 3000
  features:
    enable-cache: true
    log-level: debug
• 新建一个 Java 类（如 AppConfig），加上 @ConfigurationProperties(prefix = "app") 和 @Component（确保被 Spring 容器管理）；
• 类中字段名需与配置项小写短横线（kebab-case）一一对应，例如 enableCache 对应 enable-cache；
• 必须提供 public 的 setter 方法（Lombok 的 @Data 可自动补齐）；
• 若需启用 JSR-303 校验（如 @NotBlank），加上 @Validated 注解，并引入 spring-boot-starter-validation 依赖。

用 @Value 绑定（适合单个简单值）

适用于少量、零散、不需要结构化管理的配置项。

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

• 直接在字段上标注，例如：@Value("${app.name:default-name}")，冒号后是默认值；
• 支持基本类型、字符串，也支持 SpEL 表达式，如 @Value("#{systemProperties['os.name']}")；
• 不支持直接绑定集合或嵌套对象（如 app.features 整体），需逐个取值；
• 无法做统一前缀管理，多个配置需重复写完整 key，维护性较差。

注意 Bean 的注册时机和扫描范围

只有被 Spring 容器托管的 Bean 才能完成属性注入。

• 加 @Component 是最简方式，但要求该类所在包在主启动类的扫描路径下（默认扫描主类所在包及子包）；
• 也可用 @Configuration + @Bean 方式显式注册，配合 @ConfigurationProperties 写在方法上；
• 若配置类不在默认扫描路径，需用 @ComponentScan 显式指定，或改用 @EnableConfigurationProperties(AppConfig.class) 主动启用。

验证绑定是否生效

最直接的方法是在 Controller 或 Service 中注入该 Bean，打印字段值或用单元测试断言。

• 启动应用时，若配置项缺失而字段不可为空（且开启了校验），会抛出 BindException；
• IDE（如 IDEA）配合 Spring Boot 插件，能对 application.yml 中的 key 实时提示并跳转到对应 Java 字段；
• 可通过 /actuator/configprops 端点（需引入 spring-boot-starter-actuator）查看所有已绑定的配置类及其值。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南