Java技术：运行时如何检查特定ClassLoader可见的类

在Java环境中，想要在运行时获取特定ClassLoader可见的类，有几种实用方案，各有适用场景：

1. 利用Instrumentation API（标准可靠方案） #

这是Java官方提供的标准方式，能精准获取目标ClassLoader已加载的所有类，需要通过Java Agent实现：

步骤示例： #

• 编写Agent类，通过premain方法获取Instrumentation实例：

import java.lang.instrument.Instrumentation;
import java.util.ArrayList;
import java.util.List;

public class ClassLoaderAgent {
    private static Instrumentation instrumentation;

    public static void premain(String agentArgs, Instrumentation inst) {
        instrumentation = inst;
    }

    // 对外提供获取目标ClassLoader已加载类的方法
    public static List<Class<?>> getLoadedClassesByClassLoader(ClassLoader targetLoader) {
        List<Class<?>> result = new ArrayList<>();
        if (instrumentation == null) {
            throw new IllegalStateException("Agent未初始化");
        }
        for (Class<?> clazz : instrumentation.getAllLoadedClasses()) {
            if (clazz.getClassLoader() == targetLoader) {
                result.add(clazz);
            }
        }
        return result;
    }
}

• 打包Agent时，在MANIFEST.MF中指定Premain-Class: ClassLoaderAgent
• 运行主程序时添加JVM参数：-javaagent:你的agent.jar，之后即可调用getLoadedClassesByClassLoader方法获取目标ClassLoader的已加载类。

2. 反射访问ClassLoader内部结构（非标准、兼容性差） #

部分JVM实现（如HotSpot）的ClassLoader内部会维护已加载类的私有集合，可通过反射访问，但仅适合临时排查，不推荐生产环境使用：

示例代码（针对HotSpot JVM）： #

import java.lang.reflect.Field;
import java.util.Vector;
import java.util.List;
import java.util.stream.Collectors;

public class ClassLoaderInspector {
    public static List<Class<?>> getLoadedClasses(ClassLoader classLoader) throws Exception {
        // 反射获取ClassLoader私有字段"classes"（HotSpot特有）
        Field classesField = ClassLoader.class.getDeclaredField("classes");
        classesField.setAccessible(true);
        Vector<Class<?>> classes = (Vector<Class<?>>) classesField.get(classLoader);
        return classes.stream().collect(Collectors.toList());
    }
}

注意：该方法依赖JVM内部实现，JDK版本升级或更换JVM（如OpenJ9）后可能失效，且违反封装原则，风险较高。

3. 外部JVM工具（适合排查场景） #

若无需代码集成，可通过JDK自带工具查看：

• 使用jcmd：执行jcmd <进程ID> GC.class_histogram，输出结果会显示每个类对应的ClassLoader，可筛选目标Loader的类
• 使用jmap：执行jmap -histo <进程ID>，同样能查看类与ClassLoader的对应关系
• 使用VisualVM/JConsole：通过图形化界面查看JVM已加载类及所属ClassLoader

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