Spring通过@Profile实现多环境配置隔离，核心是按需激活Bean而非切换配置文件；只有匹配激活profile的Bean才被加载，其他同名Bean被忽略。
Spring 通过 @Profile 注解实现多环境配置隔离，核心是“按需激活 Bean”，而不是简单地切换配置文件。关键在于：只有被匹配 profile 激活的 Bean 才会被 Spring 容器加载，其他 profile 下的同名或同类 Bean 会被忽略。
profile 的定义与激活方式
profile 是一个命名的逻辑分组，用于标识某组 Bean 或配置适用于特定环境（如 dev/test/prod）。它本身不包含配置，只起“开关”作用。
- 在代码中用
@Profile("dev")标记类或方法，表示该 Bean 仅在激活dev时注册 - 激活方式有多种，优先级从高到低：JVM 参数
-Dspring.profiles.active=prod、环境变量SPRING_PROFILES_ACTIVE=prod、application.properties中写spring.profiles.active=prod、或在测试类上用@ActiveProfiles("test") - 支持同时激活多个 profile，例如
spring.profiles.active=dev,mysql，此时带@Profile({"dev", "mysql"})的 Bean 才会生效（取交集）
配合 @Configuration 类做环境专属配置
推荐将不同环境的 Bean 定义拆分成独立的 @Configuration 类，每个类标注对应 profile，清晰且易维护。
@Configuration
@Profile("dev")
public class DevDataSourceConfig {
@Bean
public DataSource dataSource() {
return new HikariDataSource(); // 内存数据库或本地 MySQL 配置
}
}
@Configuration
@Profile("prod")
public class ProdDataSourceConfig {
@Bean
public DataSource dataSource() {
// 生产环境连接池 + 密码加密 + 监控等
return new HikariDataSource();
}
}
这样无论 application.properties 中是否写了 spring.datasource.url，只要 profile 不匹配，对应 DataSource 就不会被创建 —— 真正做到“隔离”，而非“覆盖”。
立即学习“Java免费学习笔记（深入）”；
结合 application-{profile}.yml 自动加载属性
Spring Boot 会自动加载 application-dev.yml、application-prod.yml 等文件，但注意：这些文件只是提供属性值，不控制 Bean 生命周期。要让它们生效，还需在 Java Config 中引用这些属性，并确保 Config 类本身被 profile 控制。
- 例如
application-dev.yml中写app.debug: true，然后在@Profile("dev")的配置类里用@Value("${app.debug}")读取 - 避免把所有配置都塞进 yml 文件再靠
@ConditionalOnProperty切换 Bean —— 这容易导致逻辑分散、可读性差，@Profile+ 分离配置类才是更 Spring 的做法
常见误区与注意事项
很多人误以为 @Profile 是“切换配置文件”，其实它控制的是 Bean 的注册时机。几个典型问题：
-
默认 profile 未设导致 Bean 全部失效：如果没显式激活任何 profile，且所有 Bean 都加了
@Profile，那容器里可能一个 Bean 都没有。可通过@Profile("default")或不加注解来定义默认行为 -
profile 名大小写敏感：
@Profile("PROD")和spring.profiles.active=prod不匹配，建议统一小写 -
XML 配置也支持 profile：在
<beans profile="dev">中声明的 Bean 同样受控，适合遗留项目 -
Web 应用可通过 Servlet 上下文参数激活：在
web.xml中设置<context-param><param-name>spring.profiles.active</param-name><param-value>test</param-value></context-param>
