编辑“︁Spring Boot外部配置”︁

{{DISPLAYTITLE:Spring Boot外部配置}}

'''Spring Boot外部配置'''是Spring框架中用于管理应用程序配置的核心机制之一，它允许开发者在不修改代码的情况下，通过外部资源（如配置文件、环境变量、命令行参数等）动态调整应用行为。本条目将详细介绍其工作原理、优先级规则及实际应用场景。

== 概述 ==
Spring Boot通过统一的'''Environment'''抽象层加载外部配置，支持多种配置源并按优先级合并。核心设计目标是实现'''约定优于配置'''，同时保留灵活性。外部配置的主要用途包括：
* 环境适配（开发/测试/生产环境切换）
* 敏感信息隔离（如数据库密码）
* 运行时参数调整

== 配置源与优先级 ==
Spring Boot按以下顺序加载配置（后出现的配置覆盖前者）：

<mermaid>
pie title 配置源优先级
    "1. 命令行参数" : 15
    "2. JNDI属性" : 10
    "3. Java系统属性" : 12
    "4. 操作系统环境变量" : 13
    "5. 应用外的Profile-specific配置" : 11
    "6. 应用内的Profile-specific配置" : 10
    "7. 应用外的默认配置" : 14
    "8. 应用内的默认配置" : 15
</mermaid>

数学表示为：
<math>
PriorityScore = \sum_{i=1}^{n} (SourceWeight_i \times OverrideFactor_i)
</math>

== 配置格式 ==
=== 1. 属性文件（.properties） ===
传统键值对格式：
<syntaxhighlight lang="ini">
# application.properties
server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
</syntaxhighlight>

=== 2. YAML配置 ===
支持层次化结构：
<syntaxhighlight lang="yaml">
# application.yml
server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: admin
</syntaxhighlight>

== 代码示例 ==
=== 基础注入 ===
<syntaxhighlight lang="java">
@RestController
public class ConfigDemoController {
    
    @Value("${custom.message:Default Value}")
    private String message;

    @GetMapping("/message")
    public String showMessage() {
        return message;
    }
}
</syntaxhighlight>

测试用例：
{| class="wikitable"
|-
! 配置值 !! 响应输出
|-
| 未设置 || <code>Default Value</code>
|-
| <code>custom.message=Hello</code> || <code>Hello</code>
|}

=== 类型安全配置 ===
<syntaxhighlight lang="java">
@Configuration
@ConfigurationProperties(prefix = "mail")
public class MailConfig {
    private String host;
    private int port;
    // getters & setters
}
</syntaxhighlight>

对应配置：
<syntaxhighlight lang="yaml">
mail:
  host: smtp.example.com
  port: 587
</syntaxhighlight>

== 高级特性 ==
=== Profile特定配置 ===
文件命名规则：
* <code>application-{profile}.properties</code>
* <code>application-{profile}.yml</code>

激活方式：
<syntaxhighlight lang="bash">
java -jar app.jar --spring.profiles.active=prod
</syntaxhighlight>

=== 加密配置 ===
使用Jasypt集成：
<syntaxhighlight lang="xml">
<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.4</version>
</dependency>
</syntaxhighlight>

加密值格式：
<code>ENC(加密字符串)</code>

== 实际案例 ==
=== 多环境数据库配置 ===
<code>application-dev.yml</code>:
<syntaxhighlight lang="yaml">
spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
</syntaxhighlight>

<code>application-prod.yml</code>:
<syntaxhighlight lang="yaml">
spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/appdb
    username: ${DB_USER}
    password: ${DB_PASS}
</syntaxhighlight>

=== 云原生配置 ===
Kubernetes部署时结合ConfigMap：
<syntaxhighlight lang="yaml">
# k8s-configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  application.yaml: |
    logging:
      level:
        root: INFO
    cache:
      timeout: 300s
</syntaxhighlight>

== 最佳实践 ==
* 将敏感信息存储在环境变量或Vault中
* 使用<code>@ConfigurationProperties</code>替代<code>@Value</code>实现类型安全
* 为不同环境维护独立的Profile文件
* 在<code>application.properties</code>中设置通用默认值

== 常见问题 ==
=== 配置未生效 ===
检查顺序：
# 确认配置源在优先级列表中
# 检查属性拼写（包括大小写）
# 验证Profile是否激活

=== 复杂类型绑定 ===
对于嵌套对象，需提供完整的属性路径：
<syntaxhighlight lang="yaml">
server:
  ssl:
    enabled: true
    key-store: classpath:keystore.jks
</syntaxhighlight>

对应Java类：
<syntaxhighlight lang="java">
@ConfigurationProperties(prefix = "server.ssl")
public class SslConfig {
    private boolean enabled;
    private Resource keyStore;
    // getters & setters
}
</syntaxhighlight>

== 扩展阅读 ==
* [[Spring Boot官方文档 - 外部化配置]]
* [[微服务配置管理模式]]
* [[十二要素应用原则]]

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring Boot]]