深入理解 Spring 的环境配置与 Profile

application.properties/application.yml：默认配置文件，存放通用配置；
application-{profile}.properties/application-{profile}.yml：按 Profile 命名的配置文件，存放特定环境的配置；
@PropertySource 注解：在代码中指定额外的配置文件。

三、Profile 的使用方式

1. 在配置文件中激活 Profile

在 application.properties 中通过 spring.profiles.active 属性指定激活的 Profile：

# 激活开发环境Profile
spring.profiles.active=dev

也可以在 application.yml 中使用 spring.profiles 字段以 YAML 格式配置：

spring:
  profiles: dev
  datasource:
    url: jdbc:h2:mem:testdb
    username: sa
    password:

2. 在代码中使用 @Profile 注解

通过 @Profile 注解标记 Bean 或配置类，使其仅在特定 Profile 激活时生效：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.jdbc.datasource.DriverManagerDataSource;

import javax.sql.DataSource;

@Configuration
public class DataSourceConfig {

    @Bean
    @Profile("dev")
    public DataSource devDataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        dataSource.setUrl("jdbc:h2:mem:devdb");
        dataSource.setUsername("sa");
        dataSource.setPassword("");
        return dataSource;
    }

    @Bean
    @Profile("prod")
    public DataSource prodDataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        dataSource.setUrl("jdbc:mysql://prod-db:3306/mydb");
        dataSource.setUsername("user");
        dataSource.setPassword("password");
        return dataSource;
    }
}

上述代码中，devDataSource 仅在 dev Profile 激活时创建，prodDataSource 仅在 prod Profile 激活时创建。

3. 命令行参数激活 Profile

启动应用时通过命令行参数指定激活的 Profile：

java -jar myapp.jar --spring.profiles.active=test

4. 操作系统环境变量激活 Profile

设置操作系统环境变量 SPRING_PROFILES_ACTIVE 来激活 Profile：

export SPRING_PROFILES_ACTIVE=prod
java -jar myapp.jar

四、环境配置文件的加载优先级

当存在多个配置文件时，Spring 按照以下优先级加载配置：

命令行参数：最高优先级，可覆盖其他配置；
操作系统环境变量；
application-{profile}.properties/application-{profile}.yml：按激活的 Profile 加载；
application.properties/application.yml：默认配置文件，优先级最低。

例如，若 application.properties 中配置了 server.port=8080，而命令行参数指定 --server.port=8081，则最终应用将使用 8081 作为端口。

五、Profile 的高级应用

1. 多 Profile 组合

可以同时激活多个 Profile，Spring 会合并这些 Profile 的配置。例如：

properties

spring.profiles.active=dev,logging

上述配置表示同时激活 dev 和 logging 两个 Profile，logging Profile 可专门用于配置日志相关参数。

2. 条件化配置

结合 @Conditional 注解和 Profile，实现更复杂的条件配置。例如，仅在开发环境且操作系统为 Linux 时创建特定 Bean：

java

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;

@Configuration
public class ConditionalConfig {

    @Bean
    @Profile("dev")
    @Conditional(OsLinuxCondition.class)
    public String linuxDevBean() {
        return "This bean is only created in dev environment on Linux";
    }
}

3. 配置文件占位符替换

在配置文件中使用 ${} 占位符引用其他配置项或系统属性，并支持默认值设置：

# application.properties
app.name=MyApp
app.version=1.0

# application-dev.properties
app.description=${app.name} - ${app.version} (Development Version)
app.log.level=DEBUG

上述配置中，app.description 使用了 app.name 和 app.version 的值，并添加了额外说明。

六、最佳实践与注意事项

最小化默认配置：将通用配置放在 application.properties 中，避免在特定 Profile 中重复配置；
版本控制：确保不同环境的配置文件都纳入版本控制，便于追溯和管理；
安全配置：生产环境的敏感信息（如数据库密码、API 密钥）应通过环境变量或安全配置工具（如 HashiCorp Vault）管理，避免直接写入配置文件；
测试覆盖：在自动化测试中，应覆盖不同 Profile 的配置场景，确保配置切换的正确性。

七、总结

Spring 的环境配置与 Profile 机制为应用在不同环境下的差异化配置提供了强大而灵活的解决方案。通过合理运用 Profile 注解、配置文件和多种激活方式，开发者可以轻松实现配置的隔离与切换，提升应用的可维护性和适应性。在实际开发中，结合项目需求和最佳实践，充分发挥这一机制的优势，能够有效降低环境管理的复杂度，保障应用在各环境下的稳定运行。