不同版本的 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 版本

  1. 在面板“控制台”页面先关闭服务器。
  2. 进入顶部导航栏的“启动”页面,在 Java 镜像下拉框中选择对应的 Java 版本(支持 Java 8、11、16、17、21、25 等)。
  3. 返回“控制台”重新点击开机,新的 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