在 SpringBoot 开发中，配置文件是连接程序与外部环境的桥梁，它能灵活适配不同场景的需求，避免硬编码带来的维护难题。本文将从配置文件的核心作用出发，详解两种主流格式的语法特性与差异，并通过实战案例展示其实际应用。

一、配置文件的核心价值

配置文件的本质是将程序中易变的信息集中管理，解决硬编码的局限性。在 SpringBoot 项目中，它主要承担以下职责：

• 自定义服务配置：如修改内置 Tomcat 的默认端口（8080 端口常被占用时可自定义）；
• 配置外部依赖：如数据库连接信息（URL、用户名、密码）、第三方接口密钥等；
• 日志与调试：配置日志输出级别、异常追踪等信息，助力问题定位。

简单来说，配置文件让程序从 "固定不变" 变为 "灵活可调"，比如手机字体大小的配置逻辑 —— 若硬编码写死字体，所有用户只能使用同一大小；而通过配置文件存储用户偏好，程序启动时动态读取，即可实现个性化显示。

二、SpringBoot 支持的配置文件格式

SpringBoot 官方支持三种配置文件格式，其中application.yml（yaml的简写）因简洁性成为实际开发的首选，下面重点对比主流的两种格式：

2.1 格式类型与加载规则

SpringBoot 会自动从classpath路径加载以下配置文件：

1. application.properties：早期默认格式，键值对结构；
2. application.yml/application.yaml：树形结构，语法更简洁；
3. 特殊说明：两种格式可共存，但配置冲突时properties优先级更高，实际开发建议统一使用一种格式。

2.2 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("${key}")注解读取配置值，代码示例：

@RestController
public class PropertiesController {
    // 读取配置文件中的mykey.key1值
    @Value("${mykey.key1}")
    private String key1;

    @RequestMapping("/key")
    public String getKey() {
        return "读取到的值：" + key1;
    }
}

缺点

存在大量冗余前缀，如spring.datasource在 URL、用户名、密码配置中重复出现，导致配置繁琐。

2.3 yml 格式详解

yml是 "另一种标记语言"（Yet Another Markup Language），采用树形缩进结构，可读性更强，支持更多数据类型。

核心语法规则

1. 基础结构：key: value（冒号后必须加空格，否则语法错误）；
2. 层级关系：通过换行缩进表示（缩进空格数无强制要求，但同层级需一致）；
3. 注释：使用#添加注释。

数据类型支持

yml 支持字符串、布尔值、数值、null、集合、对象等多种类型，示例如下：

# 字符串（默认无需引号）
string:
  hello: bite
  str1: Hello \n Spring Boot  # 无引号：特殊字符不转义
  str2: 'Hello \n Spring Boot' # 单引号：转义特殊字符
  str3: "Hello \n Spring Boot" # 双引号：不转义特殊字符

# 布尔值
boolean:
  flag: true

# 数值
int:
  value: 10
float:
  value: 3.14

# null（~表示null）
null:
  value: ~

# 集合（List）
dbtypes:
  name:
    - mysql
    - sqlserver
    - db2

# 对象（Student）
student:
  id: 1
  name: Java
  age: 18
# 对象行内写法：student: {id: 1, name: Java, age: 18}

# Map
maptypes:
  map:
    k1: kk1
    k2: kk2
# Map行内写法：maptypes: {map: {k1: kk1, k2: kk2}}

读取方式

• 简单值：同 properties，使用@Value("${key}")；
• 对象 / 集合 / Map：需使用@ConfigurationProperties注解绑定配置类，代码示例（以对象为例）：

1. 定义配置类并绑定前缀：

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

// 绑定配置文件中的student前缀
@ConfigurationProperties(prefix = "student")
@Component
@Data // Lombok注解，自动生成getter/setter
public class Student {
    private int id;
    private String name;
    private int age;
}

    2. 注入使用：

@RestController
public class StudentController {
    @Autowired
    private Student student;

    @RequestMapping("/readStudent")
    public String readStudent() {
        return student.toString(); // 输出：Student(id=1, name=Java, age=18)
    }
}

优缺点

• 优点：可读性高、语法简洁、支持多数据类型、跨语言兼容（Golang、Python 等均支持）；
• 缺点：对格式要求严格（缩进错误会导致配置失效），复杂配置场景下可读性下降。

三、实战：基于配置文件的验证码功能

下面通过 Hutool 工具实现验证码功能，展示配置文件的实际应用 —— 将验证码的尺寸、Session 键名等可配置项存入 yml，实现灵活调整。

3.1 需求与准备

• 需求：生成图形验证码并校验，验证通过跳转至成功页；
• 依赖：引入 Hutool 验证码工具包：

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-captcha</artifactId>
    <version>5.8.22</version>
</dependency>

3.2 配置文件（application.yml）

将验证码尺寸、Session 键名等配置存入 yml：

captcha:
  width: 200  # 验证码宽度
  height: 100 # 验证码高度
  session:
    key: CAPTCHA_SESSION_KEY  # 存储验证码的Session键
    date: KAPTCHA_SESSION_DATE # 存储生成时间的Session键

3.3 核心实现

1. 配置类绑定

@Data
@Component
@ConfigurationProperties(prefix = "captcha")
public class CaptchaProperties {
    private Integer width;
    private Integer height;
    private Session session;

    @Data
    public static class Session {
        private String key;
        private String date;
    }
}

2. 验证码生成与校验

import cn.hutool.captcha.CaptchaUtil;
import cn.hutool.captcha.LineCaptcha;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import java.io.IOException;
import java.util.Date;

@RestController
@RequestMapping("/captcha")
public class CaptchaController {
    @Autowired
    private CaptchaProperties captchaProperties;
    private static final long VALID_TIME = 60 * 1000; // 验证码有效期1分钟

    // 生成验证码
    @RequestMapping("/getCaptcha")
    public void getCaptcha(HttpSession session, HttpServletResponse response) throws IOException {
        // 从配置文件读取尺寸
        LineCaptcha captcha = CaptchaUtil.createLineCaptcha(
                captchaProperties.getWidth(),
                captchaProperties.getHeight()
        );
        // 存储验证码与生成时间到Session
        session.setAttribute(captchaProperties.getSession().getKey(), captcha.getCode());
        session.setAttribute(captchaProperties.getSession().getDate(), new Date());
        // 输出验证码图片
        response.setContentType("image/jpeg");
        captcha.write(response.getOutputStream());
    }

    // 校验验证码
    @RequestMapping("/check")
    public boolean checkCaptcha(String captcha, HttpSession session) {
        if (captcha == null) return false;
        // 从Session读取存储的验证码与时间
        String savedCaptcha = (String) session.getAttribute(captchaProperties.getSession().getKey());
        Date createTime = (Date) session.getAttribute(captchaProperties.getSession().getDate());
        // 校验：非空+一致+在有效期内
        if (savedCaptcha != null && captcha.equalsIgnoreCase(savedCaptcha)) {
            return createTime != null && System.currentTimeMillis() - createTime.getTime() < VALID_TIME;
        }
        return false;
    }
}

3.4 测试效果

1. 访问http://127.0.0.1:8080/captcha/getCaptcha获取验证码图片；
2. 输入验证码后调用/captcha/check接口校验，通过则跳转至成功页。

四、总结

1. 格式对比：properties 采用key=value键值对，冗余度高；yml 采用树形结构，简洁灵活，支持更多数据类型；
2. 读取方式：简单值用@Value("${key}")，复杂结构（对象 / 集合）用@ConfigurationProperties；
3. 最佳实践：优先使用 yml 格式，避免多种格式共存，配置项需添加清晰注释；
4. 核心原则：将易变信息（如端口、密钥、尺寸）放入配置文件，保持代码的稳定性与可维护性。

掌握 SpringBoot 配置文件的使用，是实现项目灵活部署与扩展的基础，合理运用配置文件能大幅提升开发效率与系统可维护性。