SpringBoot 配置文件核心作用
SpringBoot 通过规范的配置文件格式,集中管理项目各类配置信息。典型场景包括自定义服务端口、数据库连接参数(用户名、密码等)、第三方系统调用密钥以及日志级别配置。这些配置不仅影响启动行为,更是问题定位与排查的关键依据。
1. 关键配置场景
- 项目启动端口:内置 Tomcat 默认监听 8080 端口。若端口被占用,需手动修改。
- 数据库连接:持久层框架(如 MyBatis、JPA)依赖 JDBC 封装,不同环境需动态切换连接参数。
2. 快速入门:修改端口
创建项目时会自动生成 application.properties 或 application.yml。以 properties 为例,修改端口只需一行代码:
server.port=9090
重启应用后,控制台会显示 Tomcat 已启动在 9090 端口,此时访问 http://127.0.0.1:9090/login.html 即可生效,原 8080 端口将不再响应。
3. 配置文件格式对比
SpringBoot 支持三种格式:application.properties、application.yml 和 application.yaml。其中 yml 是 yaml 的简写,实际开发中最为常用。
启动时,SpringBoot 会优先从 classpath 加载文件。若同时存在多个文件,可通过 spring.config.name 指定名称。关于优先级,需注意:当 .properties 与 .yml 共存且配置冲突时,.properties 优先级更高。虽然理论上可共存,但建议统一使用一种格式以降低维护成本。
注意:IDEA 中编辑 yml 文件时,若出现乱码,通常是因为文件编码未设置为 UTF-8。检查 IDE 设置中的 File Encoding 选项即可解决,无需重启多次。
3.1 格式类比
可以将 .properties 视为'老款包装',适合简单键值对;而 .yml 则是'新版包装',采用树形结构,层级更清晰,推荐在实际业务中优先使用。
4. Properties 配置详解
4.1 基本语法
采用 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
4.2 读取配置
使用 @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 {
String key1;
String {
+ key1;
}
}


