management:
  endpoints:
    web:
      exposure:
        include: health, info, prometheus # 严格限制暴露端点，拒绝使用 '*'
  endpoint:
    health:
      show-details: when-authorized # 仅对授权访问展示具体中间件状态详情
      probes:
        enabled: true # 显式开启 K8s 存活/就绪探针支持

┌─────────────────────────────────────────────────────────────┐
│ 1. 命令行参数 (最高优先级，用于突发应急修改)                   │
│    java -jar app.jar --server.port=8081                     │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 2. JVM 系统属性 (System Properties)                         │
│    java -Dspring.profiles.active=prod -jar app.jar          │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 3. 操作系统环境变量 (Docker / K8s 容器编排最推崇方式)         │
│    export SPRING_DATASOURCE_PASSWORD=xxxx                   │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 4. Jar 包外部的 application-{profile}.yml (配置中心挂载)      │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 5. Jar 包内部的 application-{profile}.yml (默认打包配置文件) │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 6. Jar 包内部的 application.yml (通用基础配置，最低优先级)    │
└─────────────────────────────────────────────────────────────┘

java -jar app.jar --spring.profiles.active=prod

@Data
public class Result<T> {
    private Integer code;     // 状态码：200 成功，4xx 客户端错误，5xx 服务端异常
    private String message;   // 用户友好提示或错误信息
    private T data;           // 业务数据负载
    private Long timestamp;   // 响应时间戳

    public static <T> Result<T> success(T data) {
        Result<T> r = new Result<>();
        r.setCode(200);
        r.setMessage("操作成功");
        r.setData(data);
        r.setTimestamp(System.currentTimeMillis());
        return r;
    }

    public static <T> Result<T> fail(Integer code, String message) {
        Result<T> r = new Result<>();
        r.setCode(code);
        r.setMessage(message);
        r.setData(null);
        r.setTimestamp(System.currentTimeMillis());
        return r;
    }
}

@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {

    // 1. 捕获自定义业务异常（预期内的业务错误，如库存不足、密码错误）
    @ExceptionHandler(BusinessException.class)
    public Result<?> handleBusinessException(BusinessException e) {
        log.warn("业务异常: code={}, msg={}", e.getCode(), e.getMessage());
        return Result.fail(e.getCode(), e.getMessage());
    }

    // 2. 捕获 JSR-303 参数校验异常（@Valid / @NotBlank 失败）
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Result<?> handleValidationException(MethodArgumentNotValidException e) {
        String errorMsg = e.getBindingResult().getFieldErrors().stream()
                .map(FieldError::getDefaultMessage)
                .collect(Collectors.joining("; "));
        log.warn("参数校验未通过: {}", errorMsg);
        return Result.fail(400, "参数非法: " + errorMsg);
    }

    // 3. 兜底所有未捕获的不可预知系统异常（防止把数据库报错和空指针直接抛给前端）
    @ExceptionHandler(Exception.class)
    public Result<?> handleException(Exception e) {
        log.error("系统发生严重未知异常", e);
        return Result.fail(500, "系统繁忙，请稍后重试");
    }
}

┌─────────────────────────────────────────────────────────────┐
│ 步骤 1: 定义配置属性映射类 (@ConfigurationProperties)          │
│ 读取 application.yml 中 `sms.aliyun.access-key` 等自定义参数  │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 步骤 2: 编写自动配置类 (XxxAutoConfiguration)                │
│ 配合条件注解 (@ConditionalOnClass, @ConditionalOnMissingBean) │
│ 负责创建核心业务 Bean 并装配到 Spring 容器                      │
└──────────────────────────────┬──────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 步骤 3: 声明自动装配注册文件 (让 Spring 扫描识别)              │
│ 注册在 META-INF/spring/org.springframework.boot...           │
│ ...autoconfigure.AutoConfiguration.imports 文件中           │
└─────────────────────────────────────────────────────────────┘

// 步骤 1: 属性绑定类
@Data
@ConfigurationProperties(prefix = "sms.service")
public class SmsProperties {
    private boolean enabled = true;
    private String apiKey;
    private String secret;
}

// 步骤 2: 自动配置类
@AutoConfiguration
@EnableConfigurationProperties(SmsProperties.class)
@ConditionalOnProperty(prefix = "sms.service", name = "enabled", havingValue = "true", matchIfMissing = true)
public class SmsAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean(SmsSender.class) // 用户若自定义了 SmsSender，则放弃装配默认的
    public SmsSender smsSender(SmsProperties properties) {
        return new AliyunSmsSender(properties.getApiKey(), properties.getSecret());
    }
}