如何使用 System.getenv() 函数获取特定环境变量以设定应用运行环境？

本文共计918个文字，预计阅读时间需要4分钟。

使用 `System.getenv()` 获取环境变量。

真正生效的方式只有两种：

• 在启动命令前用 ENV_MODE=prod java -jar app.jar（Linux/macOS）或 set ENV_MODE=prod && java -jar app.jar（Windows cmd）
• 把变量写进服务管理配置里：比如 systemd 的 Environment=ENV_MODE=staging，Docker 的 -e ENV_MODE=ci，K8s 的 env: 配置块

区分大小写与平台兼容性陷阱

System.getenv() 在 Linux/macOS 上严格区分大小写，System.getenv("env_mode") 和 System.getenv("ENV_MODE") 是两个不同键；但在 Windows 上不区分，两者都可能返回相同值。如果你的应用要跨平台部署，必须统一约定命名风格（推荐全大写 + 下划线），并避免依赖大小写差异做逻辑分支。

更关键的是：某些容器环境（如旧版 OpenJDK 容器镜像）会默认清空非白名单环境变量。如果发现 System.getenv("PATH") 都返回 null，说明 JVM 被限制了访问权限，得改用 System.getProperty("env.mode") 配合 JVM 参数 -Denv.mode=prod 作为 fallback 方案。

如何安全地提取并解析运行模式值

直接用 System.getenv("APP_PROFILE") 拿到字符串后，别急着 .equals("prod")——空格、不可见字符、大小写混用都可能导致匹配失败。建议封装一层校验逻辑：

String profile = System.getenv("APP_PROFILE"); if (profile == null || profile.trim().isEmpty()) { throw new IllegalStateException("Missing required env var: APP_PROFILE"); } String mode = profile.trim().toLowerCase(); // 统一小写便于比较 switch (mode) { case "dev": configureForDevelopment(); break; case "test": configureForTesting(); break; case "prod": configureForProduction(); break; default: throw new IllegalArgumentException("Unknown APP_PROFILE: " + mode); }

注意点：

• 永远先判 null，再判空字符串，trim() 不能省，CI 环境有时会注入带换行的 secret 值
• 不要用 Boolean.parseBoolean() 解析模式名，它只认 "true"/"false"，对 "prod" 返回 false，极易埋雷
• 如果模式需要多级嵌套（如 "prod-us-east"），用 String.split("-")[0] 比正则更轻量、更可控

和 Spring Boot 的 spring.profiles.active 冲突怎么办

如果你用的是 Spring Boot，System.getenv("SPRING_PROFILES_ACTIVE") 和 spring.profiles.active 配置项会叠加生效，但优先级规则容易误判。Spring Boot 默认按“application.properties → 系统属性 → 环境变量”顺序覆盖，也就是说，System.setProperty("spring.profiles.active", "dev") 会比 System.getenv("SPRING_PROFILES_ACTIVE") 优先级更高。

稳妥做法是：只用环境变量控制，不在代码里手动 setProperty；并在启动时加 -Dspring.profiles.default=dev 作为兜底，避免环境变量漏配导致应用启动失败。另外，Spring Boot 2.4+ 开始默认禁用 System.getenv() 读取 profile，需显式开启：spring.config.use-legacy-processing=true 或改用 spring.config.import=optional:env:。

环境变量不是万能钥匙，它的生命周期、可见范围、跨平台行为比想象中更脆弱。真正可靠的配置策略，是把环境变量当作“开关”，只用来决定加载哪套配置文件，而不是在代码里散落一堆 if (mode.equals("prod")) 分支。