Spring Boot中@Profile注解用于按环境条件性注册Bean，与application-{env}.yml配置文件协同工作：前者控制Java配置类和Bean的注册，后者负责属性值覆盖；核心激活机制依赖spring.profiles.active显式指定。
Spring Boot 中 @Profile 注解不是用来“配合”配置文件切换的替代方案，而是与配置文件协同工作的补充手段——它主要作用于 Java 配置类（@Configuration）和 Bean 定义层面，实现**按环境条件性注册 Bean**。真正驱动多环境切换的核心机制，仍是配置文件（如 application-dev.yml）+ spring.profiles.active 的激活逻辑。
配置文件是基础：定义不同环境的属性值
先建立标准的多环境配置结构：
-
application.yml（主配置）：只写公共配置 + 激活指令
spring:
profiles:
active: dev -
application-dev.yml：开发环境专属配置
server:
port: 8081
spring:
datasource:
url: jdbc:h2:mem:devdb -
application-prod.yml：生产环境专属配置
server:
port: 8080
spring:
datasource:
url: jdbc:mysql://prod-db:3306/myapp
启动时 Spring Boot 自动加载 application.yml，读取 active 值，再合并对应 application-{profile}.yml 中的配置。这是整个多环境机制的起点。
@Profile 用在配置类上：按环境提供不同 Bean 实现
当某些组件需要完全不同的实现逻辑（不只是参数不同），就用 @Profile 控制其注册时机。例如数据库连接池配置或 mock 服务：
立即学习“Java免费学习笔记（深入）”；
- 开发环境用 HikariCP + 内存数据库，且启用 SQL 日志
- 生产环境用 Druid + 真实 MySQL，关闭日志、开启监控
可定义两个配置类，用 @Profile 标记：
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
@Profile("dev")
public class DevDataSourceConfig {
@Bean
public DataSource dataSource() { ... } // H2 + Hikari + log enabled
}
@Configuration
@Profile("prod")
public class ProdDataSourceConfig {
@Bean
public DataSource dataSource() { ... } // MySQL + Druid + monitor enabled
}
只有当前激活的 profile 匹配时，对应配置类才生效；否则整个类被忽略，不会报 Bean 名称冲突（比如都叫 dataSource）。
@Profile 用在单个 Bean 上：更细粒度控制
如果只是某个 Bean 需要差异化，不必单独建配置类，直接标注在 @Bean 方法上即可：
public class ServiceConfig {
@Bean
@Profile("dev")
public PaymentService paymentService() {
return new MockPaymentService(); // 开发用假支付
}
@Bean
@Profile("prod")
public PaymentService paymentService() {
return new RealAlipayService(); // 生产用真实支付
}
}
注意：同一配置类中不能有两个同名 @Bean 方法同时生效，所以必须用 @Profile 明确互斥关系。
激活方式不止一种：灵活适配部署场景
除了在 application.yml 里写死 spring.profiles.active，还可动态指定：
-
命令行参数（最常用）：
java -jar app.jar --spring.profiles.active=prod -
JVM 参数：
-Dspring.profiles.active=test -
环境变量：
SPRING_PROFILES_ACTIVE=dev -
Maven 打包时注入（配合
resources filtering）：
<spring.profiles.active>${env}，再用mvn clean package -Denv=prod
这些方式优先级高于配置文件中的设置，适合 CI/CD 流水线自动区分环境。
