SpringBoot 配置文件核心用法
SpringBoot 定义了规范的配置文件格式,用于集成其他框架并集中管理项目配置。典型场景包括自定义服务端口、数据库连接信息、第三方系统调用密钥以及日志配置等。
关键配置场景
- 项目启动端口 SpringBoot 内置 Tomcat 服务器,默认监听 8080 端口。若该端口被占用,需通过配置文件修改。
- 数据库连接信息 持久层框架(如 MyBatis、JPA)是对 JDBC 的封装,不同环境需动态切换数据库参数。
- 其他配置 包括第三方 API 密钥、日志级别等,便于问题定位与环境隔离。
配置文件格式对比
SpringBoot 支持三种主要格式:application.properties、application.yml 和 application.yaml。
- properties:传统键值对格式,SpringBoot 默认生成。
- yml/yaml:树形结构,可读性更强,实际开发中推荐使用。
优先级说明
理论上两者可共存,启动时都会加载。若配置冲突,.properties 的优先级高于 .yml。建议统一使用一种格式以降低维护成本。
注意:YAML 是 "Yet Another Markup Language" 的缩写,
.yml是其简写形式,二者用法一致。
Properties 配置详解
基本语法
采用 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 注解注入配置值。
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;
}
}


