SpringBoot02-application配置文件

原创已于 2025-07-19 14:33:30 修改 · 1.1k 阅读

25 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

于 2025-07-17 22:25:48 首次发布

Spring Boot 专栏收录该内容

7 篇文章

订阅专栏

Spring Boot 的配置文件主要用于配置项目的运行参数和环境变量，常用的有 application.properties 和 application.yml（或 application.yaml）两种格式。

一、配置文件的作用

配置文件可以用于配置：

类型	举例
应用基本信息	应用名、端口号、环境等
数据库	数据库连接信息
日志	日志级别、路径
缓存	Redis、EhCache
消息队列	Kafka、RabbitMQ
安全配置	登录认证、权限
自定义参数	可以被 `@Value` 或 `@ConfigurationProperties` 读取

二、文件格式

Spring Boot 支持两种配置格式：

配置项的内容一致，只是格式不一样！推荐使用yml的格式！

2-1. `application.properties` 示例

# 服务器端口
server.port=8081

# 应用名
spring.application.name=myapp

# 数据库连接
spring.datasource.url=jdbc:mysql://localhost:3306/testdb
spring.datasource.username=root
spring.datasource.password=123456

# 日志级别
logging.level.com.example.demo=DEBUG

2-2. `application.yml/application.yaml` 示例（推荐使用，可读性更强）

server:
  port: 8081

spring:
  application:
    name: myapp
  datasource:
    url: jdbc:mysql://localhost:3306/testdb
    username: root
    password: 123456

logging:
  level:
    com.example.demo: DEBUG

2-3、配置文件的内容

配置文件的具体内容是可以在springboot的官网搜索到的：

https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html

注意：

不是所有的properties都能写的！properties是和你当前项目用到的技术有关的！

2-4、yaml配置文件，没有提示

这是因为idea不认为yaml后缀的文件是一个配置文件。

三、配置文件的位置（优先级）

若是三种配置文件同时存在：（.properties, .yml, .ymal）

优先级是：.properties > .yml > .ymal

而且这三种配置文件的内容，共存叠加，相同覆盖（根据优先级）！

Spring Boot 会自动加载以下位置的配置文件，优先级从高到低：

命令行参数（例如 --server.port=8088）
application.properties 或 application.yml （放在 src/main/resources 目录下）
外部配置（例如通过 -Dspring.config.location=xxx 指定）

四、多环境配置（Profile）

你可以为不同环境配置不同的文件，例如：

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

主配置文件中指定当前环境：

spring:
  profiles:
    active: dev

Spring Boot 会自动加载 application-dev.yml 的配置。

五、读取配置的方式

1. 使用 `@Value`

@Value("${server.port}")
private int port;

2. 使用 `@ConfigurationProperties`（适合绑定一组配置）

my:
  app:
    name: hello
    version: 1.0

@Component
@ConfigurationProperties(prefix = "my.app")
public class AppConfig {
    private String name;
    private String version;
    // getters and setters
}

六、自定义配置和获取

你也可以在配置文件中添加自定义属性，例如：

custom:
  greeting: "Hello, Spring Boot!"

【注意】：

1、值前面要有空格！

2、相同层级，左对齐。

3、大小写敏感

6-1、数组或列表（List）的配置

1、YAML 格式中的数组设置

（1）、常用方式：使用 - 符号列出元素

（2）、另一种方式：用逗号分隔字符串（效果同上）

2、Properties 格式中的数组设置

用逗号分隔值（最常见方式）

my.servers=192.168.0.1,192.168.0.2,192.168.0.3

6-2、配置信息的获取

1、通过 `@Value("${键名}")获取：`

读取数组：

yml配置文件中的值相互引用：${属性名}

特殊字符转义：用双引号报告，才会转义！

【@Value获取配置信息的缺点】：

若是成员变量很多，每个都要加@Value会很麻烦。

`2、@ConfigurationProperties(prefix = "前缀")` 读取

将一组数据，封装为一个对象！这个对象要被spring识别，要加上@Component注解！

【注意】：

1、要让创建的对象被spring识别，要加上@Component！

2、application.yml / application.properties文件中的信息被修改了，并不需要重新打包、部署项目代码！

3、Environment对象

七、总结

功能	推荐方式
单个配置读取	`@Value`
一组配置读取	`@ConfigurationProperties`
多环境切换	使用 `spring.profiles.active`
可读性	建议使用 `application.yml`