编辑“︁Spring Boot Profiles”︁

= Spring Boot Profiles =  
'''Spring Boot Profiles''' 是一个强大的功能，允许开发者根据不同的环境（如开发、测试、生产）动态配置应用程序的行为。通过使用 Profiles，可以轻松管理不同环境下的属性、Bean 注册和依赖关系，而无需修改代码。

== 介绍 ==  
在软件开发中，应用程序通常需要在不同的环境中运行，例如开发环境（Development）、测试环境（Testing）和生产环境（Production）。每个环境可能需要不同的配置，例如数据库连接、日志级别或外部服务 URL。  

Spring Boot Profiles 提供了一种机制，允许开发者通过定义不同的配置文件（如 `application-dev.properties`、`application-prod.properties`）来区分这些环境，并在运行时激活特定的 Profile。  

== 核心概念 ==  
=== 1. 激活 Profiles ===  
可以通过多种方式激活 Profile：  
* **命令行参数**：`--spring.profiles.active=dev`  
* **环境变量**：`SPRING_PROFILES_ACTIVE=prod`  
* **配置文件**：在 `application.properties` 或 `application.yml` 中设置 `spring.profiles.active`  

=== 2. Profile-specific 配置文件 ===  
Spring Boot 会自动加载与激活的 Profile 对应的配置文件，命名格式为 `application-{profile}.properties` 或 `application-{profile}.yml`。  

例如：  
* `application-dev.properties`（开发环境配置）  
* `application-prod.properties`（生产环境配置）  

=== 3. 默认 Profile ===  
如果没有显式激活任何 Profile，Spring Boot 会使用 `default` Profile，加载 `application.properties` 或 `application.yml`。  

== 代码示例 ==  
以下是一个简单的示例，展示如何在 Spring Boot 中使用 Profiles 来配置不同的数据源。  

=== 配置文件示例 ===  
'''application-dev.properties'''（开发环境）：  
<syntaxhighlight lang="properties">  
spring.datasource.url=jdbc:h2:mem:devdb  
spring.datasource.username=devuser  
spring.datasource.password=devpass  
logging.level.org.springframework=DEBUG  
</syntaxhighlight>  

'''application-prod.properties'''（生产环境）：  
<syntaxhighlight lang="properties">  
spring.datasource.url=jdbc:mysql://localhost:3306/proddb  
spring.datasource.username=produser  
spring.datasource.password=prodpass  
logging.level.org.springframework=ERROR  
</syntaxhighlight>  

=== 在代码中使用 Profiles ===  
可以通过 `@Profile` 注解来限定 Bean 的注册条件：  
<syntaxhighlight lang="java">  
@Configuration  
public class DataSourceConfig {  

    @Bean  
    @Profile("dev")  
    public DataSource devDataSource() {  
        // 返回开发环境的数据源  
        return DataSourceBuilder.create()  
            .url("jdbc:h2:mem:devdb")  
            .username("devuser")  
            .password("devpass")  
            .build();  
    }  

    @Bean  
    @Profile("prod")  
    public DataSource prodDataSource() {  
        // 返回生产环境的数据源  
        return DataSourceBuilder.create()  
            .url("jdbc:mysql://localhost:3306/proddb")  
            .username("produser")  
            .password("prodpass")  
            .build();  
    }  
}  
</syntaxhighlight>  

=== 运行应用程序 ===  
通过命令行激活 Profile：  
<syntaxhighlight lang="bash">  
java -jar myapp.jar --spring.profiles.active=dev  
</syntaxhighlight>  

== 实际应用场景 ==  
=== 场景 1：多环境日志配置 ===  
在开发环境中，可能需要详细的日志（DEBUG 级别），而在生产环境中仅记录错误日志（ERROR 级别）。通过 Profiles，可以轻松切换日志级别。  

=== 场景 2：数据库切换 ===  
开发环境可能使用内存数据库（如 H2），而生产环境使用 MySQL 或 PostgreSQL。通过 `@Profile` 注解，可以动态注册不同的数据源 Bean。  

=== 场景 3：外部 API 端点 ===  
测试环境可能使用模拟 API，而生产环境使用真实 API。通过 Profiles，可以动态配置不同的 API URL。  

== 高级用法 ==  
=== 组合 Profiles ===  
可以同时激活多个 Profiles，例如：  
<syntaxhighlight lang="properties">  
spring.profiles.active=dev,cloud  
</syntaxhighlight>  

=== 条件化配置 ===  
使用 `@Conditional` 和 `@Profile` 结合，实现更复杂的条件化 Bean 注册：  
<syntaxhighlight lang="java">  
@Bean  
@Profile("cloud")  
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true")  
public CloudService cloudService() {  
    return new AwsCloudService();  
}  
</syntaxhighlight>  

== 总结 ==  
Spring Boot Profiles 是管理多环境配置的强大工具，通过以下方式简化开发：  
* 分离不同环境的配置  
* 动态注册 Bean  
* 灵活切换运行时行为  

掌握 Profiles 的使用，可以显著提高应用程序的可维护性和部署效率。  

== 扩展阅读 ==  
* [[Spring Boot 官方文档 - Profiles]]  
* [[Spring Boot 属性配置详解]]

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