在Java虚拟机运行过程中，所有被类加载器加载的类都可以通过Instrumentation接口提供的方法进行查询，其中getAllLoadedClasses方法能够返回当前JVM中所有已经加载的类的数组，是类信息检索的常用工具。
Instrumentation接口与getAllLoadedClasses方法
Instrumentation是Java语言提供的一个高级特性，主要用于在Java程序运行时对字节码进行修改、类信息获取等操作，它的实例通常只能在Java Agent的启动入口中获取。getAllLoadedClasses是Instrumentation接口中定义的方法，其方法签名如下：
// Instrumentation接口中的方法定义 public Class<?>[] getAllLoadedClasses();
该方法不需要传入任何参数，执行后会返回一个Class<?>[]数组，数组中的每个元素都是当前JVM中已经加载的类的Class对象，包括系统类、用户自定义类以及第三方依赖类。
获取Instrumentation实例的步骤
由于Instrumentation实例无法在普通的应用代码中直接创建，必须通过Java Agent的方式获取，具体步骤如下：
1. 编写Agent入口类
Agent类需要包含premain方法，JVM启动时会自动调用这个方法并传入Instrumentation实例，我们可以将实例保存到静态变量中供后续使用：
import java.lang.instrument.Instrumentation;
public class LoadedClassAgent {
// 保存Instrumentation实例的静态变量
private static Instrumentation instrumentation;
// premain方法，JVM启动时自动调用
public static void premain(String args, Instrumentation inst) {
instrumentation = inst;
}
// 对外提供获取Instrumentation实例的方法
public static Instrumentation getInstrumentation() {
return instrumentation;
}
}
2. 配置Agent打包信息
需要在项目的META-INF/MANIFEST.MF文件中添加Premain-Class配置，指定Agent的入口类：
Manifest-Version: 1.0 Premain-Class: LoadedClassAgent
3. 启动应用时加载Agent
打包Agent为jar后，启动Java应用时通过-javaagent参数指定Agent的jar包路径：
java -javaagent:/path/to/agent.jar -jar your_application.jar
使用getAllLoadedClasses检索已加载类
获取到Instrumentation实例后，就可以直接调用getAllLoadedClasses方法获取所有已加载的类，以下是一个完整的示例：
import java.lang.instrument.Instrumentation;
public class LoadedClassRetriever {
public static void main(String[] args) {
// 获取Instrumentation实例
Instrumentation instrumentation = LoadedClassAgent.getInstrumentation();
if (instrumentation == null) {
System.out.println("未获取到Instrumentation实例，请确认Agent是否正确加载");
return;
}
// 调用getAllLoadedClasses获取所有已加载类
Class<?>[] allLoadedClasses = instrumentation.getAllLoadedClasses();
System.out.println("当前JVM已加载类总数：" + allLoadedClasses.length);
// 遍历输出类信息，这里只输出前10个类作为示例
int printCount = Math.min(10, allLoadedClasses.length);
System.out.println("部分已加载类信息：");
for (int i = 0; i < printCount; i++) {
Class<?> clazz = allLoadedClasses[i];
System.out.println("类名：" + clazz.getName() + "，类加载器：" + clazz.getClassLoader());
}
}
}
注意事项
- getAllLoadedClasses返回的类数组包含JVM启动时就加载的基础类，比如java.lang.Object、java.lang.String等，数量通常较多，遍历时需要注意性能问题。
- 如果Agent是通过attach方式动态加载的，那么对应的入口方法需要是
agentmain，而不是premain，但获取Instrumentation实例的逻辑类似。 - 该方法返回的是调用时刻的已加载类快照，如果在调用之后又有新的类被加载，不会包含在这个结果中。
- 返回的类数组可能包含已经被卸载的类的Class对象吗？不会，JVM中类卸载后对应的Class对象会被回收，因此getAllLoadedClasses只会返回当前仍然存活的已加载类。
常见使用场景
getAllLoadedClasses方法常用于以下场景：
- 应用运行时类信息监控，统计已加载类的数量、类加载器分布等信息。
- 热更新框架中，先获取所有已加载的类，再针对需要更新的类进行字节码替换。
- 问题排查时，确认某个类是否已经被正确加载到JVM中。
- 字节码增强工具中，筛选需要增强的目标类。
InstrumentationgetAllLoadedClasses类加载Java_agent修改时间：2026-06-19 23:15:25