Java 17.0.3反射无法获取DeclaredField「usr_paths」问题求助

问题根源 #

usr_paths并非ClassLoader类的字段，而是**sun.misc.Launcher$AppClassLoader的父类URLClassLoader**（部分JDK版本中属于Launcher$ExtClassLoader）的私有字段，直接通过ClassLoader.class获取必然找不到。另外Java 9+模块化之后，该字段的位置、访问权限甚至存在性都可能发生变化。

可行解决方案 #

方案1：定位正确的类获取字段 #

通过当前线程的类加载器向上遍历父类，找到实际包含usr_paths的类，修改后的代码如下：

import java.io.File;
import java.io.IOException;
import java.lang.reflect.Field;

public static void addDir(String s) throws IOException {
    try {
        // 获取当前线程的上下文类加载器（通常为AppClassLoader）
        ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
        Class<?> clazz = classLoader.getClass();
        // 向上遍历父类，直到找到ClassLoader的子类
        while (clazz != ClassLoader.class) {
            clazz = clazz.getSuperclass();
        }
        // 获取usr_paths字段
        Field field = clazz.getDeclaredField("usr_paths");
        field.setAccessible(true);
        String[] paths = (String[]) field.get(null);
        
        // 检查路径是否已存在，避免重复添加
        for (String path : paths) {
            if (s.equals(path)) {
                return;
            }
        }
        
        // 扩展路径数组
        String[] tmp = new String[paths.length + 1];
        System.arraycopy(paths, 0, tmp, 0, paths.length);
        tmp[paths.length] = s;
        field.set(null, tmp);
        
        // 更新系统属性中的库路径
        String currentLibPath = System.getProperty("java.library.path");
        System.setProperty("java.library.path", currentLibPath + File.pathSeparator + s);
    } catch (IllegalAccessException e) {
        throw new IOException("Failed to get permissions to set library path");
    } catch (NoSuchFieldException e) {
        throw new IOException("Failed to get field handle to set library path");
    }
}

方案2：适配Java 9+模块化环境 #

Java 9及以后的模块化系统会隐藏sun.misc等内部包，直接反射访问会触发模块访问限制。可以通过添加JVM启动参数解除限制：

--add-opens java.base/jdk.internal.loader=ALL-UNNAMED

如果需要使用更合规的方式，可改用模块化API（如ModuleLayer）或反射调用ClassLoader的addURL方法（该方法为protected，仍需反射）。

方案3：避免反射，使用启动参数 #

如果只是为了添加库路径，最稳定且兼容性最好的方式是在JVM启动时直接指定参数：

-Djava.library.path=原有库路径:新增路径

这种方式无需依赖内部实现，适合生产环境使用。

注意事项 #

• 反射访问私有字段依赖JDK内部实现，不同厂商（Oracle、OpenJDK、Azul）或版本的JDK可能存在差异，代码无法保证跨版本完全兼容。
• Java 16+对反射的限制进一步加强，可能需要额外添加--illegal-access=permit参数才能正常访问内部字段。

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