Java System.setProperty() 方法详解：原理、用法与注意事项

认真发呆

发布时间：2026-10-16 | 2人浏览过

原创

在使用 Java 开发时，`System.setProperty()` 是配置 JVM 环境的重要手段。本文将深入解析该方法的操作原理、具体实现步骤以及在项目中的应用场景。

核心功能与定义

System.setProperty(String key, String value) 方法的主要作用是在当前运行的 JRE（Java Runtime Environment）中设置一个名为 key 的系统属性，并将其值设为 value。这里的“系统”指的是 JVM 层面，而非底层操作系统。

该方法执行后：

返回值：返回该属性之前的旧值；若此前未设置过该属性，则返回 null。
内存机制：设置后的属性存储在 JVM 内部，相当于一个全局静态变量，整个应用程序生命周期内均可访问。

操作步骤与代码演示

以下通过实际案例说明如何设置和获取自定义系统属性。

第一步：在静态块或初始化阶段设置属性

为了确保属性尽早加载，通常将其放在类的静态初始化块（static {}）或独立工具类的方法中。这样可以在其他代码引用该属性之前完成赋值。

public class SystemTest {
    
    // 静态初始化块会在类加载时自动执行
    static {
        setValue();
    }

    public static void setValue() {
        // 设置全局系统属性键值对
        System.setProperty("name", "张三");
        System.setProperty("age", "28");
    }
    
    public static void main(String[] args) {
        // 通过 System.getProperty 读取设置的值
        System.out.println(System.getProperty("name"));
        System.out.println(System.getProperty("age"));
    }
}

第二步：验证输出结果

运行上述代码，控制台将按顺序打印出设置的全局变量值：

张三

28

关键注意事项

触发异常的场景

调用该方法时需防范以下异常情况：

SecurityException：安全管理器禁止修改指定属性。
NullPointerException：key 或 value 传入 null 时会抛出此异常。
IllegalArgumentException：key 参数为空字符串时会抛出。

优先级限制：命令行参数覆盖运行时设置

虽然 System.setProperty() 可在运行时动态赋值，但 JVM 命令行参数（如 -Dname=李四）拥有最高优先级。如果在启动时通过命令行了传参，即使在代码内部通过 setProperty 再次赋值，最终取到的仍是启动时的值。反之，如果未在启动参数中定义，代码内的设置才能生效。