Spring Boot 中应避免手动 if 判断 Profile，而应使用 @Profile、@ConditionalOnProperty 和 application-{profile}.yml 等原生机制实现声明式环境隔离。
在 spring boot 中，不推荐用 if 逻辑手动判断 profile 加载配置，因为 spring profile 本身是声明式、容器级的环境隔离机制，硬编码 if 判断会绕过 spring 的生命周期管理、破坏条件化 bean 注册逻辑，还容易引发配置覆盖混乱或 profile 未生效问题。正确做法是利用 spring 原生支持的 profile 机制（如 @profile、@conditionalonproperty、spring.profiles.active 配置驱动），让容器自动完成“按环境加载”的职责。
用 @Profile 注解精准控制 Bean 的环境归属
这是最直接、最符合 Spring 设计哲学的方式：把不同环境的实现类打上对应 Profile 标签，Spring 启动时自动匹配激活的 Profile 并注册对应 Bean。
- 定义开发环境专用服务：
@Profile("dev")
public class DevEmailService implements EmailService { ... }
- 定义生产环境专用服务：
@Profile("prod")
public class ProdEmailService implements EmailService { ... }
- 只要启动时指定
spring.profiles.active=prod，容器就只注册ProdEmailService，无需任何 if 判断 - 支持组合 Profile，例如
@Profile({"dev", "test"})或@Profile("!prod")
通过 application-{profile}.yml 实现配置文件自动切换
Spring Boot 默认支持按 Profile 自动加载 application-dev.yml、application-prod.yml 等文件，所有配置项（数据库地址、超时时间、开关标志）都可按环境差异化定义。
- 在
application.yml中统一设置激活策略：
profiles:
active: ${SPRING_PROFILES_ACTIVE:dev}
- 运行时可通过 JVM 参数、环境变量或命令行指定：
--spring.profiles.active=prod - 配置项可被
@Value或@ConfigurationProperties直接注入，天然支持 Profile 隔离
用 @ConditionalOnProperty 实现细粒度开关控制
当需要“同一环境内按业务开关启用某功能”（比如 dev 环境下可选开启 mock 模式），可用属性条件代替硬编码 if：
- 定义一个带条件的 Bean：
@ConditionalOnProperty(name = "app.feature.mock-enabled", havingValue = "true")
public MockClient mockClient() { return new MockClient(); }
- 在
application-dev.yml中写：app.feature.mock-enabled: true，在application-prod.yml中设为false - 这样既保持 Profile 分离，又避免在代码里写
if ("dev".equals(profile)) { ... }这类脆弱逻辑
避免在 Java 代码中手动读取和 if 判断 profile
以下写法是反模式，应杜绝：
// ❌ 错误示例：手动获取 profile 并 if 分支String activeProfile = environment.getActiveProfiles()[0];
if ("prod".equals(activeProfile)) {
loadProdConfig();
} else if ("dev".equals(activeProfile)) {
loadDevConfig();
}
- 它无法与 Spring 的条件化 Bean 创建、配置绑定、健康检查等机制协同工作
- profile 可能为空或有多个值（如
["dev", "docker"]），手动判断易出错 - 配置加载时机不可控，可能早于 Spring Environment 初始化
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
