指定java.ext.dirs加载冲突类却出现ClassNotFoundException求助

核心原因分析 #

1. Java版本兼容性问题（Java 9+） #

从错误栈中的java.base/jdk.internal.loader.BuiltinClassLoader可以看出你使用的是Java 9或更高版本。Java 9及以后彻底移除了扩展类加载器（Extension ClassLoader），原有-Djava.ext.dirs参数的加载机制被废弃，JVM不再从该参数指定的目录加载类——这是导致问题的根本原因，你的配置逻辑基于旧版Java的类加载模型，不适用于当前JVM版本。

2. java.ext.dirs的覆盖特性（低版本Java也可能触发） #

即使是Java 8及以下版本，显式指定-Djava.ext.dirs会覆盖JVM默认的扩展目录，而非追加。如果conflictlib目录仅包含json包，缺少其他依赖的扩展类，也可能引发加载异常，但结合错误栈的类加载器类型，这不是当前的主要问题。

3. 类加载路径未生效 #

错误显示类由AppClassLoader（系统类加载器）尝试加载，说明扩展类加载路径完全未生效，JVM根本没有去conflictlib目录查找目标类。

修复方案 #

方案1：改用模块路径（Java 9+推荐） #

基于Java 9+的模块系统处理依赖隔离：

1. 无需修改conflictlib下的jar，JVM会自动将其识别为自动模块
2. 启动命令中通过--module-path指定conflictlib目录，并用--add-modules引入需要的模块：

java -Xmx64m -XX:+HeapDumpOnOutOfMemoryError \
-Dserver.home='/home/local/tomcat/webapps/ROOT/WEB-INF' \
--module-path '/home/local/tomcat/webapps/ROOT/WEB-INF/conflictlib' \
--add-modules org.json \
-cp '/home/local/tomcat/webapps/ROOT/WEB-INF/lib' SubProcessClass

方案2：调整类路径顺序（通用兼容方案） #

直接将conflictlib的jar放在类路径最前端，让系统类加载器优先加载：

java -Xmx64m -XX:+HeapDumpOnOutOfMemoryError \
-Dserver.home='/home/local/tomcat/webapps/ROOT/WEB-INF' \
-cp '/home/local/tomcat/webapps/ROOT/WEB-INF/conflictlib/json-20140107.jar:/home/local/tomcat/webapps/ROOT/WEB-INF/lib' SubProcessClass

或者将整个conflictlib目录加入类路径并前置：

java -Xmx64m -XX:+HeapDumpOnOutOfMemoryError \
-Dserver.home='/home/local/tomcat/webapps/ROOT/WEB-INF' \
-cp '/home/local/tomcat/webapps/ROOT/WEB-INF/conflictlib/*:/home/local/tomcat/webapps/ROOT/WEB-INF/lib' SubProcessClass

类路径中顺序靠前的jar会被优先加载，以此确保conflictlib中的json包覆盖lib目录的版本。

方案3：退回到Java 8（不推荐） #

若必须依赖旧扩展类加载器机制，可切换到Java 8，但需注意：

• 确保conflictlib目录下的jar完整，无其他依赖扩展类缺失
• 保持原有启动命令格式，确认JVM版本为Java 8

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