Java 11下将jboss-modules.jar加入bootclasspath启动WildFly报ClassNotFoundException

• 问题根源为手动配置的-Xbootclasspath/a:$JBOSS_HOME/jboss-modules.jar参数破坏了WildFly 23的模块类加载初始化逻辑。
• -Xbootclasspath/a参数的作用是将指定jar包追加到JVM引导类加载器的搜索路径中，引导类加载器是JVM中优先级最高的类加载器，会优先加载路径下的所有类。
• 正常启动流程下，WildFly官方启动脚本会通过应用类加载器加载jboss-modules.jar，模块系统初始化时会自动为所有内置模块配置默认的JDK核心类依赖（包括javax.sql.DataSource这类JDK提供的标准类），类加载委派遵循标准双亲委派规则。
• 手动将jboss-modules.jar加入引导类路径后，引导类加载器会提前加载jar内的模块系统实现类，直接改变了模块系统的初始化判断逻辑：原本应该委托给JDK核心类加载器的标准类加载请求，被错误判定为需要从模块自身的依赖路径查找，最终导致org.jboss.as.clustering.common模块在加载javax.sql.DataSource时抛出ClassNotFoundException，连锁引发配置解析失败、启动流程中断。

• 直接删除JAVA_OPTS参数中配置的-Xbootclasspath/a:$JBOSS_HOME/jboss-modules.jar配置项。
• WildFly 23的内置启动脚本已经对jboss-modules.jar的加载路径做了完整适配，无需手动调整引导类路径加载该类。
• Java 9及以上版本已经逐步废弃-Xbootclasspath系列参数，这类参数本身就不推荐用于调整应用层面的类加载路径；对于Java 11的模块化运行环境，WildFly 23已经完成了全流程的JPMS适配，手动修改引导类路径属于非官方支持的操作，会直接破坏容器的类加载隔离机制。

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