一文带你深入了解SpringBoot参数配置的详细步骤

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/my_db

server:
  port: 9090
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/my_db

@Value("${my.secret.password}")
private String password; // 默认值：123456（才怪！）

# application.yml - 基础生存包
server:
  port: 8080  # 端口号，建议别用80，免得和隔壁老王冲突
  servlet:
    context-path: /api  # 上下文路径，相当于给你的应用加个姓
  
spring:
  application:
    name: my-awesome-app  # 应用名，起得霸气点准没错
  
  # 数据库配置 - 应用的“肠胃系统”
  datasource:
    url: jdbc:mysql://localhost:3306/my_db?useSSL=false&serverTimezone=UTC
    username: root
    password: IForgetItAgain  # 建议别写这里，用环境变量！
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 20  # 连接池大小，人多好办事
      minimum-idle: 5  # 最少闲着的连接，不能太懒
      connection-timeout: 30000  # 连接超时，30秒还连不上就放弃吧

# 继续在application.yml中添加
spring:
  # JPA配置 - 对象和数据库的“翻译官”
  jpa:
    show-sql: true  # 显示SQL，方便偷看它在背后说什么
    hibernate:
      ddl-auto: update  # 自动更新表结构，危险但方便！
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect
  
  # Redis配置 - 应用的“短期记忆”
  redis:
    host: localhost
    port: 6379
    timeout: 3000ms  # 超时时间，3秒还想不明白就算了
    lettuce:
      pool:
        max-active: 8  # 最大活跃连接，别太多会打架
  
  # 文件上传配置 - 胃口大小设置
  servlet:
    multipart:
      max-file-size: 10MB  # 单个文件最大，别上传整个电影！
      max-request-size: 100MB  # 总请求大小
  
# 自定义配置 - 你的专属“秘密武器”
myapp:
  config:
    max-retry-count: 3  # 重试次数，事不过三！
    enable-feature-x: true  # 要不要开启某个神秘功能
    api-key: ${API_KEY:default-key}  # 优先用环境变量，没有就用默认值

application.yml          # 公共配置，大家都得遵守
application-dev.yml     # 开发环境 - 随便折腾版
application-test.yml    # 测试环境 - 装模作样版  
application-prod.yml    # 生产环境 - 正经上班版

spring:
  datasource:
    url: jdbc:h2:mem:testdb  # 内存数据库，用完就扔
    username: sa
    password: 
  h2:
    console:
      enabled: true  # 启用H2控制台，可视化偷看数据
      path: /h2-console

logging:
  level:
    com.myapp: DEBUG  # 详细日志，方便甩锅时找证据
    org.springframework.web: DEBUG

spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/prod_db?useSSL=true
    username: ${DB_USERNAME}  # 从环境变量读取，安全第一！
    password: ${DB_PASSWORD}
    
logging:
  level:
    com.myapp: WARN  # 生产环境日志别太多，磁盘会哭
    org.springframework: ERROR

management:
  endpoints:
    web:
      exposure:
        include: health,info  # 只暴露必要的监控端点

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

@Component
@ConfigurationProperties(prefix = "myapp.config")
@Data  // Lombok注解，自动生成getter/setter
public class MyAppConfig {
    /**
     * 最大重试次数
     * 默认值：防止有人不配置时系统直接崩溃
     */
    private int maxRetryCount = 3;
    
    /**
     * 是否开启神秘功能X
     * 默认值：false（安全第一）
     */
    private boolean enableFeatureX = false;
    
    /**
     * API密钥
     * 建议：写在配置文件里不如写在环境变量里
     * 写在环境变量里不如写在脑子里（但容易忘）
     */
    private String apiKey = "change-me";
    
    /**
     * 服务器列表
     * 示例配置：myapp.config.servers[0]=http://server1
     *         myapp.config.servers[1]=http://server2
     */
    private List<String> servers = new ArrayList<>();
    
    /**
     * 连接超时时间
     * 单位：毫秒
     * 哲学问题：等待多久才算真爱？
     */
    private Duration connectionTimeout = Duration.ofSeconds(30);
}

// 使用配置类
@Service
public class MyService {
    @Autowired
    private MyAppConfig config;
    
    public void doSomething() {
        if (config.isEnableFeatureX()) {
            System.out.println("神秘功能已开启，但没人知道是啥功能");
        }
        
        for (int i = 0; i < config.getMaxRetryCount(); i++) {
            try {
                // 尝试做事
                break;
            } catch (Exception e) {
                System.out.println("第" + (i+1) + "次失败，还剩" + 
                    (config.getMaxRetryCount() - i - 1) + "次机会");
            }
        }
    }
}

# 运行时指定配置
java -jar myapp.jar --server.port=9090 --spring.profiles.active=prod

# 使用环境变量（Linux/Mac）
export SPRING_DATASOURCE_PASSWORD=SuperSecret123
export MYAPP_CONFIG_APIKEY=MyAwesomeKey
java -jar myapp.jar

# 使用环境变量（Windows PowerShell）
$env:SPRING_DATASOURCE_PASSWORD="SuperSecret123"
java -jar myapp.jar

import javax.validation.constraints.*;

@Component
@ConfigurationProperties(prefix = "myapp.config")
@Validated  // 开启验证
@Data
public class ValidatedConfig {
    
    @NotNull(message = "API密钥不能为空，除非你想裸奔")
    @Size(min = 10, max = 100, message = "API密钥长度要在10-100之间")
    private String apiKey;
    
    @Min(value = 1, message = "重试次数至少1次，放弃治疗不可取")
    @Max(value = 10, message = "重试次数最多10次，要学会放弃")
    private int maxRetryCount = 3;
    
    @Pattern(regexp = "^(http|https)://.*", message = "URL必须以http或https开头")
    private String baseUrl;
    
    @AssertTrue(message = "如果开启功能X，必须提供密钥")
    public boolean isFeatureXValid() {
        return !enableFeatureX || (apiKey != null && !apiKey.isEmpty());
    }
}

# 添加Spring Cloud Config依赖后
spring:
  cloud:
    config:
      enabled: true
  config:
    import: optional:configserver:http://localhost:8888  # 配置中心地址

# 在需要刷新的类上添加
@RefreshScope
@Component
public class ConfigRefreshService {
    @Value("${myapp.config.feature-toggle}")
    private String featureToggle;
    // 配置更新后，这个值会自动刷新！
}

# 使用jasypt加密敏感信息
spring:
  datasource:
    password: ENC(加密后的字符串)  # 看起来像乱码就对了
    
# 启动时提供加密密钥
java -jar myapp.jar --jasypt.encryptor.password=my-secret-key