@Profile是Spring中用于按环境条件注册Bean的核心机制，它通过标注在@Configuration类、@Component组件或@Bean方法上实现粗粒度到细粒度的环境控制，并需通过spring.profiles.active等方式显式激活对应环境才能生效。
在 Spring 中，@Profile 是控制 Bean 按环境条件注册的核心机制。它不是“开关”或“if 判断”，而是决定某个组件是否被 Spring 容器加载——只有当前激活的 Profile 匹配时，带 @Profile 的类或方法才会生效。
怎么标注 @Profile
它可以加在三种地方，作用范围不同：
-
加在配置类（
@Configuration）上：整个类里所有@Bean方法都受约束。比如@Profile("prod")的配置类，只在生产环境注册其中全部 Bean。 -
加在组件类（
@Component、@Service、@Repository等）上：该组件仅在指定 Profile 下被扫描并注册。适合不同环境有不同实现逻辑的场景，例如@Profile("dev")的 MockService 和@Profile("prod")的 RealService。 -
加在
@Bean方法上：最细粒度控制，同一配置类中可为不同环境提供同名但不同实现的 Bean（如两个dataSource()方法分别标@Profile("dev")和@Profile("prod")）。
怎么激活指定环境
必须显式告诉 Spring 当前运行在哪种 Profile，否则只加载未标注 @Profile 的 Bean（即默认环境）。常用方式有：
-
配置文件中设置：在
application.yml或application.properties里写spring.profiles.active=dev（支持多个，用逗号分隔，如dev,mysql）。 -
启动时传参：运行 JAR 时加 JVM 参数
-Dspring.profiles.active=test，或命令行参数--spring.profiles.active=prod。 -
代码中设置（较少用）：在
SpringApplication.run()前调用setAdditionalProfiles("staging")，适用于测试或特殊启动逻辑。
常见使用模式
实际项目中，@Profile 常配合以下结构使用：
立即学习“Java免费学习笔记（深入）”；
-
多套数据源：开发环境用嵌入式 H2，生产环境连 MySQL，各自
@Bean方法标注对应 Profile。 -
差异化服务实现：定义接口
PaymentService，MockPaymentService标@Profile("dev")，AlipayPaymentService标@Profile("prod")，注入时自动选型。 -
环境专属配置类：把日志级别、缓存策略、第三方 SDK 初始化等按环境拆到不同
@Configuration类，并用@Profile隔离。 -
避免冲突命名：多个 Profile 下提供同名 Bean（如都叫
dataSource），需确保它们不同时激活，否则启动报错。
注意事项
几个容易踩坑的关键点：
- 没激活任何 Profile 时，默认只加载
@Profile("default")或无@Profile的 Bean；spring.profiles.default可改默认值，但一般不建议动。 -
@Profile("!dev")表示“非 dev 环境”，可用于兜底逻辑，但慎用，易引发预期外行为。 - Profile 名区分大小写，
dev和DEV是两个不同环境。 - 和
application-{profile}.yml配合使用效果最佳：配置文件管属性，@Profile管组件，二者互补而非替代。
