Java项目环境隔离核心是配置分离与行为可控，而非硬编码判断：通过Spring Boot的application-{profile}.yml实现配置隔离，敏感信息交由配置中心或K8s Secret管理，Bean按@Profile动态注册，调试接口与监控端点按环境开关。
Java项目中区分开发与生产环境，核心在于配置隔离和行为可控，而不是靠硬编码判断环境名称。关键不是“怎么写if判断”，而是“如何让同一套代码在不同环境自动加载对应配置、连接对应服务、启用对应功能”。
配置文件按环境分离（推荐Spring Boot方式）
Spring Boot天然支持application-{profile}.yml机制。例如：
-
application.yml：主配置，定义通用项（如spring.profiles.active: dev默认激活dev） -
application-dev.yml：本地开发用，数据库连H2、日志级别DEBUG、启用Swagger -
application-prod.yml：生产环境用，数据库连MySQL集群、日志级别INFO、关闭调试端点
启动时通过--spring.profiles.active=prod或JVM参数-Dspring.profiles.active=prod指定，无需改代码。
敏感信息不进代码库（配置中心 or 外部挂载）
数据库密码、API密钥、第三方私钥等，绝不能写在application-prod.yml里提交到Git。正确做法：
立即学习“Java免费学习笔记（深入）”；
- 生产环境使用配置中心（如Nacos、Apollo），应用启动时拉取加密后的配置
- 或通过K8s ConfigMap/Secret挂载为文件或环境变量，再由Spring Boot的
@ConfigurationProperties绑定 - 本地开发可用
~/.env或IDE运行配置设置DB_PASSWORD=xxx，配合@Value("${DB_PASSWORD:default}")提供兜底
Bean注册按环境动态生效
某些组件只应在特定环境存在，比如邮件服务在开发环境用Mock实现，生产才连真实SMTP：
@Configuration
public class MailConfig {
@Bean
@Profile("dev")
public JavaMailSender mockMailSender() {
return new MockJavaMailSender(); // 仅dev生效
}
@Bean
@Profile("prod")
public JavaMailSender realMailSender() {
return new JavaMailSenderImpl(); // 仅prod生效
}
}
也可用@ConditionalOnProperty(name = "mail.enabled", havingValue = "true")做更细粒度控制。
接口与监控的环境感知开关
开发阶段需要的调试能力，上线后必须禁用：
- Actuator端点：
management.endpoints.web.exposure.include=health,info（生产只开必要项） - Swagger UI：
springdoc.api-docs.enabled=false+springdoc.swagger-ui.enabled=false（生产设为false） - 自定义调试接口：加
@Profile("!prod")注解，确保无法在生产调用
这类开关应统一在application-prod.yml中集中关闭，避免遗漏。
环境隔离不是加几个if就能解决的事，它是一套从配置、依赖、部署到运维的协同设计。重点是让环境差异变成可声明、可验证、可审计的配置项，而不是散落在代码里的字符串比较。
