<!-- 如果使用的是 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;
/**
 * 短信服務(wù)配置
 * 使用 @Validated 注解開啟校驗
 * 使用 @ConfigurationProperties 綁定前綴為 "sms" 的配置
 */
@Component
@Validated // 關(guān)鍵注解1：告訴Spring需要對此Bean進(jìn)行校驗
@ConfigurationProperties(prefix = "sms") // 關(guān)鍵注解2：綁定配置前綴
public class SmsProperties {
    /**
     * 服務(wù)商API地址
     * 本次事故的罪魁禍?zhǔn)祝?
     * @NotBlank 確保該值不能為 null 或空字符串
     */
    @NotBlank(message = "【短信服務(wù)】關(guān)鍵配置 'sms.url' 未配置，請檢查配置文件！")
    private String url;
    /**
     * 授權(quán)密鑰
     */
    @NotBlank(message = "【短信服務(wù)】關(guān)鍵配置 'sms.secret-id' 未配置")
    private String secretId;
    /**
     * 操作密鑰
     */
    @NotBlank(message = "【短信服務(wù)】關(guān)鍵配置 'sms.secret-key' 未配置")
    private String secretKey;
    /**
     * 重試次數(shù)
     * @NotNull 確保數(shù)字類型的配置不為空
     * @Min 設(shè)置最小值
     */
    @NotNull(message = "【短信服務(wù)】配置 'sms.retry-times' 未配置")
    @Min(value = 0, message = "【短信服務(wù)】配置 'sms.retry-times' 的值不能小于0")
    private Integer retryTimes;
    /**
     * 是否啟用短信服務(wù)（生產(chǎn)環(huán)境才啟用，開發(fā)測試環(huán)境可能不啟用）
     * 這里使用了默認(rèn)值 false，即使不配置也不會報錯
     */
    private Boolean enabled = false;
    // 標(biāo)準(zhǔn)的 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();
            // ... 實際調(diào)用發(fā)送邏輯
            System.out.println("正在調(diào)用短信服務(wù): " + targetUrl);
        } else {
            System.out.println("短信服務(wù)未啟用，已忽略發(fā)送。");
        }
    }
}

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: 【短信服務(wù)】關(guān)鍵配置 'sms.url' 未配置，請檢查配置文件！
    Property: sms.secret-key
    Value: null
    Reason: 【短信服務(wù)】關(guān)鍵配置 'sms.secret-key' 未配置
    Property: sms.retry-times
    Value: -1
    Reason: 【短信服務(wù)】配置 'sms.retry-times' 的值不能小于0
Action:
Update your application's configuration