Java中应区分环境变量(System.getenv()读取)与系统属性(System.getProperty()读取):前者是进程启动时OS环境快照,后者是JVM启动参数;混用将导致取值失败。

Java 中的 System 类是访问运行环境最直接的入口,关键在于分清“环境变量”和“系统属性”——它们来源不同、用途不同、读取方式也不同,混用就会拿不到值。
怎么安全读取操作系统环境变量
用 System.getenv(String name) 直接传变量名,比如 System.getenv("HOME") 或 System.getenv("PATH")。这是推荐做法,性能好且规避了权限问题。
- 别写
System.getenv().get("HOME"):返回的是只读不可变 Map,在 Java 9+ 模块化或 Web 容器中可能触发SecurityException - 必须判空:环境变量可能根本没设置,建议用
Objects.requireNonNullElse(System.getenv("TMPDIR"), "/tmp")提供默认值 - 注意大小写:Linux/macOS 区分大小写(
"path"≠"PATH"),Windows 不区分,跨平台代码统一用大写键名 - 值是进程启动时的快照:后续系统里改了环境变量,Java 进程不会自动更新
怎么正确获取 JVM 系统属性
System.getProperty(String key) 读的是 JVM 启动时加载的配置,不是操作系统环境变量。常见误区是把 Docker 的 ENV TZ=Asia/Shanghai 当成系统属性去取,结果为 null。
- 内置属性无需设置:如
"os.name"、"java.version"、"user.home"、"file.separator"都可直接读 - 自定义属性要加
-D参数:启动命令写java -Dapp.env=prod MyApp,才能用System.getProperty("app.env") -
"user.dir"是当前工作目录,"user.home"才是用户主目录,别混淆
两个方法不能互相替代的典型场景
判断部署环境时,常需组合使用:
- 查是否在容器中:
System.getenv("KUBERNETES_SERVICE_HOST") != null(环境变量) - 查当前 profile:
System.getProperty("spring.profiles.active")(JVM 属性,由 Spring Boot 设置) - 拼路径时注意分隔符:
System.getProperty("user.home") + System.getProperty("file.separator") + "config" - 读数据库地址:优先从
System.getenv("DB_URL")获取,未设置再 fallback 到System.getProperty("db.url")
额外提醒:别误用 setProperty 和 getenv
System.setProperty() 只影响当前 JVM 内部,不影响操作系统;System.getenv() 无法通过 Java 代码修改系统环境变量——它只是只读快照。
- 不要试图用
System.setProperty("PATH", "...")去改系统 PATH,无效 - 需要动态变更环境变量的场景(如热加载配置路径),得靠外部机制(如监听文件、调用脚本)配合
- 敏感变量(如密码)不建议塞进环境变量再用
getenv读,应走更安全的凭据管理方案

















