Spring Boot 配置加载与绑定实战

• application-dev.yml
• application-test.yml
• application-prod.yml

application.yml

spring:
  profiles:
    active: dev # 默认激活开发环境

激活方式也很直接：

• 配置文件里设置
• 命令行：java -jar yourapp.jar --spring.profiles.active=prod
• JVM 参数：-Dspring.profiles.active=test
• 环境变量：export SPRING_PROFILES_ACTIVE=prod

在代码里读取配置

@Value：适合单个属性

@Component
public class MyComponent {
    @Value("${server.port}")
    private int serverPort;

    @Value("${app.message: Hello Default}") // 使用冒号指定默认值
    private String message;
}

这种写法简单，够用的时候很快；但属性一多，维护起来就开始散。

@ConfigurationProperties：绑定一组配置

这个更适合正式项目，类型安全，也更像是在定义一个配置对象，而不是到处拼字符串。

步骤 1：在 application.yml 中定义配置

app:
  user:
    name: "Alice"
    age: 30
    email: "[email protected]"
    hobbies:
      - reading
      - hiking

步骤 2：创建配置类绑定属性

@Component
@ConfigurationProperties(prefix = "app.user") // 前缀是 app.user
@Data // Lombok 注解，自动生成 getter/setter
public class UserProperties {
    private String name;
    private Integer age;
    private String email;
    private List<String> hobbies;
}

步骤 3：注入使用

@Service
public class MyService {
    @Autowired
    private UserProperties userProperties;

    public void doSomething() {
        System.out.println("User name: " + userProperties.getName());
        System.out.println("User hobbies: " + userProperties.getHobbies());
    }
}

如果配置类上已经加了 @Component，一般就不需要再在启动类上额外加 @EnableConfigurationProperties。这类注解堆太多，后面自己也容易看懵。

常见配置示例

# 服务器配置
server:
  port: 8080
  servlet:
    context-path: /api # 应用上下文路径

# 数据源配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

# JPA 配置
jpa:
  hibernate:
    ddl-auto: update # 生产环境不要用 create-drop 或 update
    show-sql: true

# 日志配置
logging:
  level:
    root: info
    org.springframework.web: debug
    com.example: trace
  file:
    name: logs/myapp.log # 输出到文件

# 自定义配置
myapp:
  feature:
    enabled: true
    api-url: https://api.example.com

这里有个小细节：ddl-auto: update 在开发期省事，线上就不太合适了，数据库结构变更最好还是自己控制，别把风险交给启动时自动处理。

结语

Spring Boot 的配置体系本质上就三件事：默认值怎么来、外部配置怎么覆盖、Java 里怎么把配置稳妥地接住。properties 能用，yml 更顺手；命令行和环境变量适合部署覆盖；一组相关配置还是交给 @ConfigurationProperties 更稳。真正写项目时，配置不是越多越好，能分层、能覆盖、能回滚，才算好用。