Eclipse启动Minecraft 1.8.9 Forge客户端时出现ClassCastException错误
错误根因
该报错属于老旧构建工具链与高版本JDK的兼容缺陷,与项目业务代码无关:
- 1.8.9版本Minecraft配套的旧版ForgeGradle插件,在
GradleForgeHacks.searchCoremods方法中硬编码了强转逻辑:将系统默认类加载器直接转换为URLClassLoader类型 - 该强转操作仅在Java 8环境下可正常运行:Java 8的AppClassLoader实现继承自URLClassLoader;从Java 9开始JDK完成模块化改造,AppClassLoader的实现被替换为
jdk.internal.loader.ClassLoaders$AppClassLoader,该类不再继承URLClassLoader,强转时直接抛出ClassCastException,和错误栈中的触发逻辑完全匹配 - 注意:尝试通过添加JVM启动参数开放模块访问权限的方式无法解决该问题,因为二者不存在类继承关系,强转操作从类型层面就不成立。
修复操作步骤
- 提前安装Java 8版本的JDK(如Temurin 8),禁止使用Java 9及以上版本作为项目编译、运行环境
- 调整Eclipse运行基础:打开Eclipse安装目录下的
eclipse.ini配置文件,在-vmargs配置项上方添加两行配置,第一行填写-vm,第二行填写Java 8 JDK路径下javaw.exe的绝对路径,保存后重启Eclipse - 配置项目编译规则:右键目标项目选择
Build Path → Configure Build Path,移除Libraries页面中原有的高版本JRE System Library,替换为已配置的Java 8运行环境 - 校验启动参数:右键项目选择
Run As → Run Configurations,找到对应的Minecraft客户端启动项,在JRE设置页确认选中的是Java 8运行环境,避免误用高版本模块化JDK - 执行Gradle项目全量同步后,即可正常启动客户端。
内容的提问来源于stack exchange,提问作者Josh
相关产品推荐
相关产品推荐

