如何通过Java命令行参数向系统属性追加值而非覆盖原值

结论 #

Java没有内置的纯启动开关支持直接追加java.library.path的默认值，所有-D参数都会直接覆盖属性的默认值。以下是符合要求的可行实现方案：

方案1：手动拼接固定默认值（无代码修改，完全依赖Java原生命令） #

同版本、同操作系统下的JVM默认java.library.path是固定的，你可以先通过原生命令查询默认值：

java -XshowSettings:properties -version 2>&1 | grep "java.library.path"

拿到默认路径后，手动拼接你需要追加的路径，直接写入-D参数即可：

java -Djava.library.path=/usr/java/packages/lib:/usr/lib64:/lib64:/lib:/usr/lib:/your/custom/path 你的启动类

这个方案完全不需要依赖shell环境变量，拼接后的参数可以直接填到IDE、其他工具的Java启动参数配置中使用。

方案2：在业务代码启动最前端处理（无额外依赖） #

只需要在你启动类的main方法第一行添加属性拼接逻辑即可：

public static void main(String[] args) {
    // 读取原有值
    String originalLibPath = System.getProperty("java.library.path");
    // 追加自定义路径，Windows下用;分隔，Linux/macOS用:分隔
    String newLibPath = originalLibPath + ":/your/custom/path";
    System.setProperty("java.library.path", newLibPath);

    // 可选：如果后续需要立即加载动态库，需要清空JVM的路径缓存保证新值生效
    try {
        Field fieldSysPath = ClassLoader.class.getDeclaredField("sys_paths");
        fieldSysPath.setAccessible(true);
        fieldSysPath.set(null, null);
    } catch (Exception e) {
        // 忽略异常即可，不影响正常逻辑
    }

    // 原有业务代码
}

方案3：用Java Agent实现无侵入追加（不需要改业务代码） #

Java的-javaagent是原生支持的启动开关，你可以打包一个极简的Agent包，在启动时通过参数加载实现自动追加：

1. 编写Agent代码：

import java.lang.instrument.Instrumentation;
import java.lang.reflect.Field;

public class LibPathAppendAgent {
    public static void premain(String agentArgs, Instrumentation inst) {
        // agentArgs就是你要追加的路径，启动时传入
        String originalPath = System.getProperty("java.library.path");
        String newPath = originalPath + ":" + agentArgs;
        System.setProperty("java.library.path", newPath);
        
        // 清空缓存
        try {
            Field fieldSysPath = ClassLoader.class.getDeclaredField("sys_paths");
            fieldSysPath.setAccessible(true);
            fieldSysPath.set(null, null);
        } catch (Exception ignore) {}
    }
}

2. 打包成jar包，在MANIFEST.MF中指定Premain-Class: LibPathAppendAgent
3. 启动时添加参数即可：

java -javaagent:./lib-path-agent.jar=/your/custom/path 你的启动类

内容的提问来源于stack exchange，提问作者Anthony