【Java 开发日记】有了解过 SpringBoot 的参数配置吗？
目录
核心概念：application.properties 与 application.yml
当然了解，Spring Boot 的参数配置是其核心特性之一，也是它实现“约定大于配置”理念的关键。它极大地简化了传统 Spring 应用中繁琐的 XML 配置。
一、核心概念：application.properties 与 application.yml
Spring Boot 默认使用这两种文件进行配置（二者选其一即可，.yml 更常用）。
application.properties (传统键值对格式)
server.port=8081 spring.datasource.url=jdbc:mysql://localhost:3306/mydb spring.datasource.username=root spring.datasource.password=secret logging.level.com.example.demo=debugapplication.yml (YAML 格式，层次感更强，推荐使用)
server: port: 8081 spring: datasource: url: jdbc:mysql://localhost:3306/mydb username: root password: secret logging: level: com.example.demo: debugYAML 注意事项：缩进必须使用空格，不能使用 Tab 键，冒号后面必须有一个空格。
二、配置的加载位置与优先级
Spring Boot 会从以下位置按从高到低的优先级加载 application 配置文件（高优先级的配置会覆盖低优先级的配置）：
- 当前项目根目录下的
/config子目录 - 当前项目根目录
- classpath 下的
/config包 (即src/main/resources/config) - classpath 根路径 (即
src/main/resources)
最佳实践：在开发时，将通用配置放在 src/main/resources/application.yml 中。在打包部署时，可以在 JAR 包所在目录创建一个 config 文件夹，里面放一个 application.yml 来覆盖开发环境的配置（如数据库连接），这样就实现了配置与代码分离。
三、外部化配置（非常强大）
除了配置文件，Spring Boot 还支持多种外部配置方式，优先级高于application.yml。这在容器化部署（如 Docker）时尤其有用。
- 命令行参数
java -jar yourapp.jar --server.port=8888 --spring.datasource.url=jdbc:mysql://prod-server:3306/proddb- 操作系统环境变量
Spring Boot 会自动识别形如SPRING_DATASOURCE_URL的环境变量（注意大小写和下划线）。 - Profile-specific 配置（多环境配置）这是管理不同环境（开发、测试、生产）配置的最佳方式。在通用的
application.yml中，通过spring.profiles.active属性来激活特定环境的配置。- 配置文件命名规则：
application-{profile}.yml - 例如：
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 // 或者也可以手动写 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()); } }别忘了在启动类上添加 @EnableConfigurationProperties 注解（但如果你像上面一样在配置类上使用了 @Component，则不需要）。
五、常用配置示例
# 服务器配置 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总结
Spring Boot 的参数配置系统非常灵活和强大，其核心思想是：
- 约定大于配置：提供了大量默认配置，开箱即用。
- 配置外部化：允许你通过文件、命令行、环境变量等多种方式覆盖默认配置，轻松适应不同环境。
- 类型安全绑定：通过
@ConfigurationProperties可以轻松地将一组配置映射到 Java Bean 上，是管理自定义配置的首选方式。
如果小假的内容对你有帮助，请点赞，评论，收藏。创作不易，大家的支持就是我坚持下去的动力！
