Spring Boot 自定义配置加载：@Value 与 @ConfigurationProperties 实战

结果与目标：构建灵活的配置读取方案

Spring Boot 默认加载 application.properties 或 application.yml 中的键值对。为了实现业务逻辑与配置的解耦，我们通常需要将特定的配置项注入到组件中。主要面临两种场景：少量参数的简单注入，或多参数关联的实体类映射。

准备条件

1. 已创建 Spring Boot 项目（基于 Maven 或 Gradle）。

2. 确保引入 spring-boot-starter-web 依赖，以便后续进行 HTTP 接口验证。

3. 准备好文本编辑器或 IDE（如 IntelliJ IDEA）用于修改配置文件和编写 Java 类。

真实操作顺序

第1步：定义配置文件内容

目的：建立可供读取的外部配置源。

操作：打开项目根目录下的 src/main/resources/application.properties 文件，添加以下自定义配置：

school.name=ZHOUWorldUniversity
website=www.zhouworld.com

注意：此处定义了简单的键值对，后续将通过不同方式读取。

第2步：使用 @Value 注解进行单值注入

目的：快速将单个配置项绑定到 Bean 的属性上，适用于配置项较少且独立的情况。

入口：任意由 Spring 管理的组件类（如 @Controller、@Service 或 @Component）。

动作：

1. 在目标类的字段上添加 @Value 注解。

2. 使用 #{'配置key'} 语法指向配置文件中的 key。

代码示例：

@RestController
public class DemoController {
    @Value("${school.name}")
    private String schoolName;

    @Value("${website}")
    private String website;

    // ... getter/setters and endpoint logic

重要提示：@Value 不支持直接绑定复杂的结构体，若需绑定整组相似前缀的配置，建议使用下文的 @ConfigurationProperties。

第3步：验证 @Value 注入效果

目的：确认配置是否成功读取并赋值。

操作：

1. 启动 Spring Boot 应用。

2. 访问模拟接口，例如 http://localhost:8080/demo（假设该接口返回上述两个属性的拼接字符串）。

完成状态：浏览器或客户端应正确显示配置文件中的值（如 "ZHOUWorldUniversity"），未报错即表示注入成功。

第4步：配置批量映射数据

目的：为实体类绑定多个具有相同前缀的配置项。

操作：在 application.properties 中添加一组前缀一致的配置：

love.name=ZHOUWorldLove
love.website=www.zhouworldlove.com

这里使用了 love. 作为命名空间前缀。

第5步：创建配置实体类并使用 @ConfigurationProperties

目的：将分散的配置项聚合为一个强类型的 Java 对象。

入口：新建一个 Java 类（建议包路径清晰，如 com.example.config）。

动作：

1. 添加 @Component 注解，将此类交给 Spring IoC 容器管理。

2. 添加 @ConfigurationProperties(prefix = "love")，指定前缀以匹配配置项。

3. 确保类中的字段名与 prefix + . 后的键名完全一致（忽略大小写匹配）。

代码示例：

@Component
@ConfigurationProperties(prefix = "love")
public class LoveConfig {
    private String name;
    private String website;

    // 必须提供 Getter 和 Setter 方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getWebsite() { return website; }
    public void setWebsite(String website) { this.website = website; }
}

关键点：@ConfigurationProperties 支持松绑定（loose binding），即驼峰命名法（camelCase）可对应短横线命名（kebab-case），但 Getter/Setter 必不可少。

第6步：注入实体类并验证

目的：在其他组件中直接使用配置对象。

操作：在 Controller 或其他 Service 中通过 @Autowired 注入之前创建的 LoveConfig 实例。

@RestController
public class LoveController {
    @Autowired
    private LoveConfig loveConfig;

    @GetMapping("/love")
    public String getLoveInfo() {
        return "Name: " + loveConfig.getName() + ", Web: " + loveConfig.getWebsite();
    }
}

完成判断：访问 http://localhost:8080/love，观察返回结果是否为预期配置值。

简要总结

@Value 适合轻量级、独立的变量注入，语法简单但耦合度高；@ConfigurationProperties 更适合结构化配置，类型安全且便于校验（配合 JSR-303 注解）。根据实际业务复杂度选择合适的方式，能有效提升 Spring Boot 应用的配置管理效率。以上就是 Spring Boot 自定义配置及映射的详细内容，更多关于 Spring Boot 配置优化的资料请关注本站其它相关文章！