类加载的双亲委派:从 Bootstrap 到自定义 ClassLoader

举报
yd_254127822 发表于 2026/11/17 08:38:02 2026/11/17
【摘要】 从一次运行期 NoClassDefFoundError 出发,拆解类加载各阶段、双亲委派的查找顺序与线程上下文类加载器的例外,并给出自定义 ClassLoader、类加载日志和常见隔离问题的排查方法。

问题背景:编译通过,运行时却找不到类

插件化、热部署和依赖冲突场景里,NoClassDefFoundError、ClassNotFoundException 和 LinkageError 往往在启动之后才出现。更隐蔽的情况是同一个类名在 classpath 出现了两份:代码能编译,运行时却报 ClassCastException,提示两个看起来完全相同的类不能互转。

这不是 JVM “找错了文件”,而是因为类在 JVM 中的身份由“全限定名 + 定义它的类加载器”共同决定。同一个 com.example.Plugin 字节码,被两个不同的 ClassLoader 分别 defineClass,就会产生两个互不相干的 Class 对象。理解双亲委派,本质上是在理解两件事:字节码由谁负责查找,以及找到之后还要不要先问父加载器。

类加载的生命周期与初始化边界

一个类从字节码变成可用类型,要经历加载、验证、准备、解析、初始化和使用,最后才可能被卸载。加载阶段由 ClassLoader 完成,验证、准备、解析主要由 JVM 主导,其中解析可以推迟到首次使用之前。

准备阶段会为静态字段分配内存并设置零值;static final 的编译期常量会在准备阶段通过 ConstantValue 属性直接赋值。初始化阶段才执行 <clinit>,包括静态字段的显式赋值和静态代码块。常见的初始化触发点有:

  • 使用 new 创建实例,或访问、修改非编译期常量的静态字段;
  • 调用静态方法;
  • 通过反射调用,例如 Class.forName(name, true, loader);
  • 初始化子类时,先初始化父类。

注意,访问 static final int MAX = 10 这类编译期常量时,常量会被内联进调用方字节码,不一定会触发定义类的初始化。这个差异在依赖静态代码块注册资源的框架里很容易踩到。

加载阶段并不要求一次性把类文件读进内存,ClassLoader 可以从目录、JAR、网络甚至运行时生成的字节数组获取内容;defineClass 负责把字节数组转成 JVM 内部的 Class,而“从哪里取字节码”是加载器自己的策略。验证阶段会检查魔数、版本号、字节码语义和符号引用,准备阶段只分配静态存储,不执行 Java 代码;真正可能抛异常的业务逻辑在初始化阶段才运行。

双亲委派:loadClass 的查找顺序

JDK 9 之后,常见的委派层级是 Bootstrap、Platform、Application,再到业务自定义的 ClassLoader。Bootstrap 负责 java.lang.* 等核心类,通常由虚拟机实现,String.class.getClassLoader() 返回 null;JDK 8 则对应 Bootstrap、Extension、Application 三层。

ClassLoader.loadClass 的默认逻辑可以概括为:

  1. 先查已加载缓存 findLoadedClass;
  2. 有父加载器就调用 parent.loadClass,没有父加载器则尝试 Bootstrap;
  3. 父加载器都找不到,才调用自身的 findClass;
  4. 需要解析时调用 resolveClass。

因此默认策略是“父优先”,而不是“子优先”。这样既能避免核心类被业务同名类替换,也能避免同一个类被重复加载。但双亲委派不是语言级的强制规定,它只是 loadClass 的默认实现,子类完全可以覆盖。

这套顺序也解释了为什么 java.lang.Object 不能被同名类替换:应用类加载器即使在自己的 classpath 上看到 java/lang/Object.class,也会先交给 Bootstrap。JDK 9 之后模块边界进一步收紧,defineClass 也不允许把类定义到 java.* 包中;某些框架通过 Java Agent 或 -Xbootclasspath/a 做增强,属于受控的例外,不应成为常规做法。

一个经典例外是线程上下文类加载器(Thread Context ClassLoader,TCCL)。JDBC 的 java.sql.Driver 接口由 JDK 自带加载器加载(JDK 8 为 Bootstrap,JDK 9 及以上为 Platform),具体驱动实现却在应用 classpath 上。父加载器看不到子加载器里的实现,于是 ServiceLoader 通过 Thread.currentThread().getContextClassLoader() 打破可见性边界。使用 TCCL 时必须在 finally 中恢复原值,否则线程池中的后续任务会继承错误的类加载器。

自定义 ClassLoader 的代码与观测命令

下面这个加载器只覆盖 findClass,把类名映射到磁盘目录,并复用应用类加载器作为父加载器:

public final class PathClassLoader extends ClassLoader {
    private final Path root;

    public PathClassLoader(Path root) {
        super(PathClassLoader.class.getClassLoader());
        this.root = root;
    }

    @Override
    protected Class<?> findClass(String name) throws ClassNotFoundException {
        Path file = root.resolve(name.replace('.', '/') + ".class");
        try {
            byte[] bytes = Files.readAllBytes(file);
            return defineClass(name, bytes, 0, bytes.length);
        } catch (IOException e) {
            throw new ClassNotFoundException(name, e);
        }
    }
}

假设插件类 demo.Plugin 不在应用 classpath,只在 /opt/plugins/demo 下,可以这样加载:

ClassLoader loader = new PathClassLoader(Path.of("/opt/plugins/demo"));
Class<?> type = Class.forName("demo.Plugin", true, loader);
Object plugin = type.getDeclaredConstructor().newInstance();

如果 demo.Plugin 同时存在于应用 classpath,父加载器会先命中,findClass 根本不会执行。这正是双亲委派在起作用。确实需要“子优先”时,只能重写 loadClass,并显式排除 java.* 等必须以父加载器为准的包;这类改动风险很高,不能顺手为之。

defineClass 返回的 Class 还没有链接和初始化;如果同一个加载器再次定义同名类,JVM 会抛出 LinkageError,因此自定义加载器必须依赖 loadClass 的已加载缓存,而不是绕过它直接调用 findClass。需要并行加载多个类时,还要调用 registerAsParallelCapable(),否则 loadClass 会退化为类加载器级别的串行锁。

观测类加载行为可以用:

java -verbose:class -cp /tmp/demo Demo /tmp/plugin | grep demo.Plugin

java -Xlog:class+load=info -Xlog:class+unload=info \
     -XX:MaxMetaspaceSize=256m -cp /tmp/demo Demo /tmp/plugin

jcmd <pid> VM.classloader_stats
jmap -clstats <pid>

-Xlog:class+load=info 适用于 JDK 9 及以上;JDK 8 可以用 -verbose:class 或 -XX:+TraceClassLoading。jmap -clstats 能列出每个类加载器加载的类数量和占用,适合排查动态生成类导致的 Metaspace 增长。

实践建议与踩坑

  • 优先只重写 findClass。 loadClass 已经处理了缓存、父委派和并行加载锁;直接覆盖容易破坏双亲委派,也会遇到重复 defineClass 的 LinkageError。
  • 区分 Class.forName 与 loadClass。 Class.forName(name) 默认初始化类,ClassLoader.loadClass 默认不初始化。框架扫描类时应使用 Class.forName(name, false, loader),避免提前触发静态代码块。
  • 动态加载器要能卸载。 类卸载要求它的定义加载器、类实例和 Class 对象都不可达。若静态缓存、线程池或 TCCL 仍持有插件对象,加载器就无法回收,最终表现为 Metaspace OOM。使用 URLClassLoader 时记得 close()。
  • 不要用 TCCL 做长期状态。 线程池复用线程时,未恢复的上下文类加载器会污染后续任务,典型现象是“第一次请求正常,后续请求找不到驱动或 SPI 实现”。
  • 自定义加载器要限权。 能定义任意字节码的加载器等于拥有代码执行能力,插件来源、签名校验和包名隔离都要在加载之前完成,不能只依赖双亲委派。类加载器隔离不是安全沙箱,不能替代权限校验。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。