System.getenv()返回null的根本原因是JVM启动时未继承该环境变量，而非代码错误；需确保变量在进程启动前已存在、严格匹配大小写、避免IDE或容器环境剥离，并优先通过启动命令或配置文件注入。
System.getenv() 返回 null 的常见原因
调用 System.getenv("ENV_MODE") 却得到 null，大概率不是代码写错了，而是环境变量根本没被 JVM 启动时加载进去。Java 进程只能读取它启动那一刻操作系统已存在的环境变量，后续在终端里 export ENV_MODE=dev 再运行 java -jar app.jar 是无效的——因为 export 只影响当前 shell 子进程，而 java 是新起的独立进程，没继承这个变量。
真正生效的方式只有两种：
- 在启动命令前用
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")) 分支。
