不同版本的 Minecraft 服务端需要运行在匹配的 Java 环境上。若 Java 版本选择有误,服务器通常会在点击开机后数秒内报错并自动停机,这是新服无法启动最常见的原因之一。
☕ Minecraft 与 Java 版本对照表
| Minecraft 版本范围 | 应选择的 Java 版本 |
|---|---|
1.16.5 及以下 |
Java 8 |
1.17 – 1.17.1 |
Java 16(兼容 Java 17) |
1.18 – 1.20.4 |
Java 17 |
1.20.5 – 1.21.x |
Java 21 |
26.1 及以上 |
Java 25 |
特殊情况说明:
- 面板预置纯净端:名称中已直接注明所需的 Java 版本(例如
[1.16.5]Mohist[JAVA11]需使用 Java 11),请优先以名称标注为准。- 特殊魔改整合包:部分大型整合包(如 GTNH 等)对 Java 版本有专门要求,请以整合包作者发布的说明为准。
☕ 在面板中切换 Java 版本
- 在面板“控制台”页面先关闭服务器。
- 进入顶部导航栏的“启动”页面,在 Java 镜像下拉框中选择对应的 Java 版本(支持 Java 8、11、16、17、21、25 等)。
- 返回“控制台”重新点击开机,新的 Java 环境即刻生效。
☕ 如何通过报错日志判断 Java 版本不匹配
1. Java 版本过低(UnsupportedClassVersionError)
当控制台日志出现 UnsupportedClassVersionError 时,说明当前选用的 Java 版本低于服务端要求,典型报错如下:
has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0其中前一个数字代表服务端需要的字节码版本,后一个数字代表当前正在运行的字节码版本。对照下表即可确认应当切换的目标版本(如上例中 65.0 对应 Java 21,说明需将当前的 Java 17 切换为 Java 21):
报错中的 class file version |
对应的 Java 版本 |
|---|---|
52.0 |
Java 8 |
55.0 |
Java 11 |
60.0 |
Java 16 |
61.0 |
Java 17 |
65.0 |
Java 21 |
69.0 |
Java 25 |
2. Java 版本过高(ClassCastException)
Minecraft 1.16.5 及以下的旧版 Forge 服务端(尤其是 1.12.2)若误选了高版本 Java,启动时通常会抛出如下异常:
java.lang.ClassCastException: class jdk.internal.loader.ClassLoaders$AppClassLoader cannot be cast to class java.net.URLClassLoader遇到此类报错时,请前往面板“启动”页面将 Java 版本切换回 Java 8。
选型提示:Java 版本并非越新越好,高版本 Java 移除了旧版 Forge 依赖的部分底层接口。请严格按照上方对照表选择对应版本,切勿直接选用最高版本。
☕ 客户端 Java 环境配置
玩家本地客户端同样需要配置匹配的 Java 版本。若启动游戏时发生闪退或提示 Java 版本错误,请参考 一键安装整合包预置 中的“安装客户端与 Java 环境”章节,安装全套 Java 运行环境后,在本地启动器设置中为该整合包手动指定对应的 Java 路径。
作者:admin 创建时间:2026-11-16 23:00
最后编辑:admin 更新时间:2026-11-16 23:01
最后编辑:admin 更新时间:2026-11-16 23:01