SpringBoot @ConfigurationProperties + Validation实现启动期校验解决方案

<!-- 如果使用的是 Spring Boot 2.3+ 版本，需要显式引入 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

package com.example.demo.config;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import org.springframework.validation.annotation.Validated;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
/**
 * 短信服务配置
 * 使用 @Validated 注解开启校验
 * 使用 @ConfigurationProperties 绑定前缀为 "sms" 的配置
 */
@Component
@Validated // 关键注解1：告诉Spring需要对此Bean进行校验
@ConfigurationProperties(prefix = "sms") // 关键注解2：绑定配置前缀
public class SmsProperties {
    /**
     * 服务商API地址
     * 本次事故的罪魁祸首！
     * @NotBlank 确保该值不能为 null 或空字符串
     */
    @NotBlank(message = "【短信服务】关键配置 'sms.url' 未配置，请检查配置文件！")
    private String url;
    /**
     * 授权密钥
     */
    @NotBlank(message = "【短信服务】关键配置 'sms.secret-id' 未配置")
    private String secretId;
    /**
     * 操作密钥
     */
    @NotBlank(message = "【短信服务】关键配置 'sms.secret-key' 未配置")
    private String secretKey;
    /**
     * 重试次数
     * @NotNull 确保数字类型的配置不为空
     * @Min 设置最小值
     */
    @NotNull(message = "【短信服务】配置 'sms.retry-times' 未配置")
    @Min(value = 0, message = "【短信服务】配置 'sms.retry-times' 的值不能小于0")
    private Integer retryTimes;
    /**
     * 是否启用短信服务（生产环境才启用，开发测试环境可能不启用）
     * 这里使用了默认值 false，即使不配置也不会报错
     */
    private Boolean enabled = false;
    // 标准的 Getter 和 Setter 方法必须存在，否则配置无法注入
    public String getUrl() {
        return url;
    }
    public void setUrl(String url) {
        this.url = url;
    }
    public String getSecretId() {
        return secretId;
    }
    public void setSecretId(String secretId) {
        this.secretId = secretId;
    }
    public String getSecretKey() {
        return secretKey;
    }
    public void setSecretKey(String secretKey) {
        this.secretKey = secretKey;
    }
    public Integer getRetryTimes() {
        return retryTimes;
    }
    public void setRetryTimes(Integer retryTimes) {
        this.retryTimes = retryTimes;
    }
    public Boolean getEnabled() {
        return enabled;
    }
    public void setEnabled(Boolean enabled) {
        this.enabled = enabled;
    }
}

package com.example.demo.service;
import com.example.demo.config.SmsProperties;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class SmsService {
    // 直接注入配置Bean
    private final SmsProperties smsProperties;
    @Autowired
    public SmsService(SmsProperties smsProperties) {
        this.smsProperties = smsProperties;
    }
    public void sendSms(String phoneNumber, String content) {
        // 使用配置
        if (Boolean.TRUE.equals(smsProperties.getEnabled())) {
            String targetUrl = smsProperties.getUrl(); // 这里拿到的url肯定是有效的
            String secretId = smsProperties.getSecretId();
            // ... 实际调用发送逻辑
            System.out.println("正在调用短信服务: " + targetUrl);
        } else {
            System.out.println("短信服务未启用，已忽略发送。");
        }
    }
}

sms:
  # url: https://api.sms-service.com/send # 故意注释掉，模拟遗忘配置
  secret-id: your_secret_id_here
  # secret-key: your_secret_key_here # 也注释掉一个
  retry-times: -1 # 配置了一个非法的值

***************************
APPLICATION FAILED TO START
***************************
Description:
Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'sms' to com.example.demo.config.SmsProperties failed:
    Property: sms.url
    Value: null
    Reason: 【短信服务】关键配置 'sms.url' 未配置，请检查配置文件！
    Property: sms.secret-key
    Value: null
    Reason: 【短信服务】关键配置 'sms.secret-key' 未配置
    Property: sms.retry-times
    Value: -1
    Reason: 【短信服务】配置 'sms.retry-times' 的值不能小于0
Action:
Update your application's configuration