如何让Java ClassLoader首次加载类时输出类信息及实现方法

针对你的问题，我分三个部分来解答，从最简单的JVM内置方案到自定义ClassLoader实现，再到如何让应用使用自定义加载器，结合你Java 9的场景给出具体建议：

一、直接用JVM内置选项实现（推荐，无需修改代码） #

这是最快捷的方式，完全不需要改动代码，特别适合你现在排查问题的需求：

• 传统兼容选项（支持Java 9及更早版本）：使用 -verbose:class 参数，启动时加上它，JVM会输出每个类的加载信息，包括类名、加载它的ClassLoader，以及类文件的来源路径。示例：

  java -verbose:class YourMainClass
  

• Java 9+ 统一日志选项：Java 9引入了统一日志系统，你可以用更灵活的参数过滤和格式化输出，比如：

  java -Xlog:class+load=info YourMainClass
  

  这个参数会输出类加载的详细信息，包括加载时间、类名、ClassLoader名称，甚至Java 9模块系统下的模块归属。如果需要更细节的日志，可以把info换成debug。

这两个选项都能帮你追踪所有类的加载顺序，对于排查Java 9模块系统下的类加载冲突、缺失类等问题非常有用——毕竟堆栈不在你的代码里，类加载日志能帮你看到错误发生前加载了哪些类，定位到可能的依赖冲突或模块可见性问题。

二、继承ClassLoader实现自定义加载日志 #

如果确实需要通过自定义ClassLoader来实现，你可以重写loadClass方法（注意遵循双亲委派模型，避免类加载异常），在类首次加载时打印信息。

示例代码如下：

public class LoggingClassLoader extends ClassLoader {
    public LoggingClassLoader(ClassLoader parent) {
        super(parent); // 继承父类加载器，遵循双亲委派规则
    }

    @Override
    protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException {
        // 先检查类是否已经被加载过，确保只在首次加载时输出
        Class<?> loadedClass = findLoadedClass(name);
        if (loadedClass == null) {
            System.out.printf("[首次加载] 类名: %s | 加载器: %s%n", name, this.getClass().getSimpleName());
        }
        // 调用父类的loadClass方法，保证双亲委派逻辑不被破坏
        return super.loadClass(name, resolve);
    }
}

这里的关键是先调用findLoadedClass判断类是否已加载，避免重复输出（因为父类加载器可能已经加载过该类）。

三、让应用使用自定义ClassLoader #

有几种方式可以让你的应用使用自定义ClassLoader，根据你的场景选择：

• 方式一：用自定义ClassLoader加载主类
  写一个简单的启动类，用你的LoggingClassLoader加载应用的主类，示例：

  public class LoaderMain {
      public static void main(String[] args) throws Exception {
          LoggingClassLoader customLoader = new LoggingClassLoader(ClassLoader.getSystemClassLoader());
          // 加载你的应用主类
          Class<?> mainClass = customLoader.loadClass("com.yourpackage.YourMainClass");
          // 调用主类的main方法
          Method mainMethod = mainClass.getMethod("main", String[].class);
          mainMethod.invoke(null, (Object) args);
      }
  }
  

  启动时运行LoaderMain即可，这样所有由自定义加载器加载的类都会输出日志。

• 方式二：显式加载特定类
  如果只需要追踪特定包下的类，可以在代码中显式使用LoggingClassLoader加载这些类，比如：

  LoggingClassLoader loader = new LoggingClassLoader(Thread.currentThread().getContextClassLoader());
  Class<?> targetClass = loader.loadClass("com.somepackage.TargetClass");
  

• 方式三：替换系统类加载器（Java 9+ 不推荐）
  Java 9之前可以通过java.system.class.loader系统属性指定自定义ClassLoader，但Java 9的模块系统对系统类加载器有严格要求，需要实现模块相关接口，容易出现兼容性问题，因此不推荐在Java 9+环境下使用这种方式。

针对你的Java 9场景的建议 #

因为你是在Java 9环境下排查非业务代码的堆栈问题，优先推荐使用JVM内置的-Xlog:class+load=info选项，它不需要修改代码，能输出最准确的类加载日志，包括模块归属信息，这对于排查模块间的依赖冲突、类可见性问题是最直接有效的。

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