本文介绍了 SpringBoot 配置文件的核心用法，涵盖 Properties 和 YAML 两种格式。主要内容包括配置文件的作用（如端口、数据库连接、日志配置）、格式选择与优先级（Properties 优先级高于 YAML）、基本语法差异（键值对 vs 树形结构）。详细讲解了如何通过 @Value 和 @ConfigurationProperties 注解读取配置，以及 @PostConstruct 在初始化中的应用。同时对比了两种格式的优缺点，指出 YAML 在可读性和数据结构支持上的优势，以及 Properties 在兼容性上的特点。
SpringBoot 定义了规范的配置文件格式，用于集成其他框架，并集中管理项目各类配置信息，典型场景包括：
SpringBoot 项目创建时，会自动生成配置文件。可通过修改配置文件更改服务端口号（解决 8080 端口被占用问题）。
server.port=9090
重启后显示 Tomcat 启动端口号为 9090。 访问程序：http://127.0.0.1:9090/login.html
此时 http://127.0.0.1:8080/login.html 将无法访问。
Spring Boot 配置文件主要有以下三种：
application.propertiesapplication.ymlapplication.yaml注意：
properties优先级比yml/yaml高。yml为yaml的简写，实际开发中出现频率最高。
当应用程序启动时，Spring Boot 会自动从 classpath 路径找到并加载上述文件。也可以通过 spring.config.name 指定文件路径和名称。
类似商品包装，.properties 是传统格式（Spring Boot 项目默认），.yml 是新版格式，实际开发中更推荐使用。
.properties 和 .yml 可共存，启动时都会加载；若配置冲突，.properties 优先级更高。注意事项： IDEA 重启后可能出现乱码情况，通常需检查本地配置文件编码设置或 IDE 编码配置。
key=value 形式# 添加注释示例：
# 配置项目端口号
server.port=8080
# 配置数据库连接信息
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/testdb?characterEncoding=utf8&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
@Value 注解，以 ${key} 格式读取代码示例：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class PropertiesController {
@Value("${mykey.key1}")
private String key1;
@RequestMapping("/key")
public String key() {
return "读取到值:" + key1;
}
}
配置示例：
mykey.key1 = bite
访问 /key 接口时，会返回配置文件中 mykey.key1 对应的值。
@PostConstruct 是 Java EE 中的注解（Spring 也完全支持），作用是：在 Spring 容器创建完 Bean 实例、完成依赖注入后，自动执行标注了这个注解的方法。
简单说：Bean 先被创建 → 依赖注入（比如 @Autowired 注入的对象）→ @PostConstruct 方法执行。
适用场景：初始化数据（比如加载配置、初始化缓存、连接第三方服务）、执行 Bean 创建后的前置操作。
完整示例：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;
@Component
public class UserService {
@Autowired
private ConfigService configService;
@PostConstruct
public void init() {
// 此时 configService 已经完成注入，可安全使用
String config = configService.getConfig();
System.out.println("Bean 初始化完成，加载配置：" + config);
}
}
@Component
class ConfigService {
public String getConfig() {
return "数据库连接配置：jdbc:mysql://localhost:3306/test";
}
}
关键注意点：
@Autowired 依赖注入，早于 Bean 被业务代码使用。InitializingBean 接口（但 @PostConstruct 更简洁）。properties 配置是以 key-value 的形式配置的，配置文件中会有很多的冗余信息，例如层级关系不直观。 想要解决这个问题，就可以使用 yml 配置文件的格式化优势。
yml 是 YAML 的缩写，全称是 Yet Another Markup Language，即'另一种标记语言'。
yml 是树形结构的配置文件，它的基础语法是 key: value。
基础语法如下：
# 正确写法（冒号后必须带空格）
server:
port: 8080
host: localhost
# 错误写法（无空格，配置无法解析）
# server:port:8080
# 字符串（默认无需引号，特殊字符需加引号）
name: 张三
nickname: "zhangsan:001"
remark: 'hello\nworld'
# 数字
age: 20
score: 98.5
# 布尔值
enabled: true
disabled: false
# 空值
empty: null
# 或 ~
# 日期（ISO 8601 格式）
birthday: 2024-03-18
# 写法 1：短横线 + 空格（推荐，层级清晰）
user:
hobbies:
- 篮球
- 游泳
- 编程
# 写法 2：中括号简写（单行）
user:
tags: [Java, SpringBoot, MySQL]
# 多层嵌套（SpringBoot 常用）
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/test
username: root
password: 123456
redis:
host: 127.0.0.1
port: 6379
timeout: 5000ms
# 单行注释（仅支持单行，用 # 开头）
server:
port: 8080 # 端口配置（行内注释也需用 #）
# 多行注释需每行加 #
# 开发环境端口
# 生产环境可改为 80
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/dbname?characterEncoding=utf8&useSSL=false
username: root
password: root
string:
hello: bite
yml 读取配置的方式和 properties 相同，使用 @Value 注解即可。
Java 代码：
@RestController
public class ReadYml {
@Value("${string.hello}")
private String hello;
@RequestMapping("/ymlKey")
public String key() {
return "读取到值:" + hello;
}
}
运行结果： 页面显示：读取到值:bite
字符串默认不用加上单引号或者双引号，如果加英文的单双引号可以表示特殊的含义。
尝试在 application.yml 中配置如下信息：
string:
str1: Hello \n Spring Boot.
str2: 'Hello \n Spring Boot.'
str3: "Hello \n Spring Boot."
读取程序实现代码如下：
@RestController
public class ReadYml {
@Value("${string.str1}")
private String str1;
@Value("${string.str2}")
private String str2;
@Value("${string.str3}")
private String str3;
@RequestMapping("/yml")
public String readYml() {
System.out.println(str1);
System.out.println(str2);
System.out.println(str3);
return "yml";
}
}
执行结果：
Hello \n Spring Boot.
Hello \n Spring Boot.
Hello
Spring Boot.
从上述结果可以看出：
在 yml 中配置对象：
student:
id: 1
name: Java
age: 18
或者是使用行内写法（与上面的写法作用一致）：
student: {id: 1,name: Java,age: 18}
这个时候就不能用 @Value 来读取配置中的对象了，此时要使用另一个注解 @ConfigurationProperties 来读取。
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
@ConfigurationProperties(prefix = "student")
@Component
@Data
public class Student {
private int id;
private String name;
private int age;
}
调用类的实现如下：
@RestController
public class StudentController {
@Autowired
private Student student;
@RequestMapping("/readStudent")
public String readStudent() {
return student.toString();
}
}
配置文件也可以配置 list 集合：
dbtypes:
name:
- mysql
- sqlserver
- db2
集合的读取和对象一样，也是使用 @ConfigurationProperties 来读取的。
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.List;
@Component
@ConfigurationProperties("dbtypes")
@Data
public class ListConfig {
private List<String> name;
}
配置文件也可以配置 map：
maptypes:
map:
k1: kk1
k2: kk2
k3: kk3
Map 的读取和对象一样，也是使用 @ConfigurationProperties 来读取的。
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.HashMap;
@Component
@ConfigurationProperties("maptypes")
@Data
public class MapConfig {
private HashMap<String,String> map;
}
打印类的实现：
@RestController
public class ReadYml2 {
@Autowired
private MapConfig mapConfig;
@RequestMapping("/readMap")
public String readStudent() {
return mapConfig.toString();
}
}
转换为 yml 示例：
keycloak:
realm: demo
resource: fm-cache-cloud
credentials:
secret: d4589683-0ce7-4982-bcd3
security:
- authRoles:
- user
collections:
- name: ssologinurl
patterns:
- /login/*
对应 properties 格式如下：
keycloak.realm = demo
keycloak.resource = fm-cache-cloud
keycloak.credentials.secret = d4589683-0ce7-4982-bcd3
keycloak.security[0].authRoles[0] = user
keycloak.security[0].collections[0].name = ssologinurl
keycloak.security[0].collections[0].patterns[0] = /login/*
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online