Minecraft 常见问题

汇总 Minecraft 服务器启动失败、Java 版本不匹配、内存不足、连接失败、配置被还原、存档备份与重置等常见问题的原因和处理方法。

Minecraft · 更新于

启动与运行

开机后一直停在「启动中」

服务端控制台输出启动完成的提示后,状态才会变为「运行中」,例如 Java 版的 Done (...)! For help, type "help"、基岩版的 Server started.。首次开机需要生成世界,整合包还要加载大量模组,可能需要几分钟。

请打开「控制台」观察输出:如果日志还在滚动,说明仍在加载;如果出现报错后停止,按报错内容排查。

启动报 UnsupportedClassVersionError 或 Unsupported class file major version

这是运行镜像的 Java 版本和核心不匹配:

  • 核心要求的 Java 比当前镜像高时,会报 UnsupportedClassVersionError。
  • 老版本核心在过新的 Java 上运行,也可能报 Unsupported class file major version 等错误。

处理方法:在实例详情的「启动设置」标签中,从「运行镜像」下拉框选择正确的 JAVA 版本,点「切换镜像」(详见 启动设置)。各版本对应的 Java 要求见 服务端核心怎么选,大致规则如下:

Minecraft 版本 运行镜像
1.20.6 及以上 JAVA21
1.18 ~ 1.20.4 JAVA17
1.17.x JAVA16
1.16.5 及以下 JAVA8

具体以对应核心版本说明中的 Java 要求为准,例如 Arclight 1.20.1 需要 JAVA21。

页面提示「服务器异常退出」

提示中会带有退出码,服务器已保持关机,不会自动重启。请到「控制台」查看退出前的日志,常见原因有:

  • 模组或插件冲突、缺少前置、版本不匹配,见 安装插件与模组。
  • 配置文件写错(例如 YAML 缩进错误)。
  • 存档损坏。

排查后点「开机」重新启动。

提示「服务器因内存不足被终止(OOM)」

服务器占用的内存超过了套餐上限。可以:

  1. 升级套餐 增加内存。
  2. 在「环境变量」中调小「视距」和「模拟距离」。
  3. 精简模组或插件,减少同时在线人数。

默认启动参数会让 Java 根据套餐内存自动分配堆内存(最多约 90%),一般不需要自己加 -Xmx。如果在「启动设置」的「启动参数」中手动指定了 -Xmx,请不要设得接近或超过套餐内存。

需要手动同意 EULA 吗

不需要。安装脚本会自动写入 eula=true。如果你删除了 eula.txt 导致启动时提示需要同意 EULA,在「文件管理」中新建 eula.txt,内容写 eula=true 即可。

卡顿、TPS 低怎么办

  • 插件服优先使用 Paper 或 Purpur,它们的性能优于 Spigot。
  • 调小「视距」(建议 6~10)和「模拟距离」。
  • 清理大量掉落物、实体密集的刷怪塔或红石机器。
  • 使用性能分析插件或模组定位卡顿来源。
  • 以上都无效时,考虑 升级套餐。

配置与版本

改了 server.properties,重启后又变回去了

对应的配置项在「环境变量」中设置了值,每次开机或重启都会用环境变量覆盖文件。请改用环境变量修改,或把该变量清空(下拉框选「未设置」)后再改文件。server-port 始终由平台管理,不能修改。详见 server.properties 与游戏参数。

中文 MOTD 显示乱码

请通过「环境变量」中的「服务器描述(MOTD)」设置中文,平台会自动转换编码,重启后生效。

怎么升级或更换 Minecraft 版本

  1. 先关机并备份世界目录。
  2. 在「环境变量」中修改核心版本(例如「Paper版本」),点「保存变量」。
  3. 如果新版本要求更高的 Java,在「启动设置」中切换运行镜像。
  4. 点击「重新安装」,安装完成后手动开机。

存档只能升级不能降级,降级后可能无法加载。要换成另一种核心(例如 Paper 换成 Forge)需要使用「切换游戏」,会清空数据目录,见 重新安装与切换游戏。

重新安装会删除我的存档吗

不会。「重新安装」会先关机,然后重新运行安装脚本,数据目录中的文件会保留,但脚本可能覆盖其中的同名文件(例如服务端核心)。整合包实例会重新解压整合包,覆盖同名的配置文件。操作前仍建议备份。

控制台输入命令要加斜杠吗

不需要。在「控制台」底部输入框直接输入 op 玩家名、whitelist add 玩家名 等,按 Enter 发送,用 ↑/↓ 可以翻看历史命令。服务器未运行时无法输入命令。

连接

玩家连不上服务器

  1. 确认实例为「运行中」,且控制台已出现启动完成提示。
  2. 确认使用的是「概览」标签「玩家连接地址」中的完整地址,端口是自动分配的外网端口,不是 25565。
  3. 确认客户端版本和服务端一致;模组服需要安装相同的模组。
  4. 非正版账号需要在「环境变量」中关闭「正版验证」。

完整的排查表见 玩家如何连接服务器。

基岩版客户端更新后进不去

基岩版客户端只能连接不低于自身版本的服务端。在「环境变量」中把「Bedrock版本」改为「官方最新版」或更高的版本,保存后「重新安装」,安装完成后开机。重装会保留 server.properties、permissions.json、allowlist.json。

存档与数据

平台会自动备份存档吗

平台暂不提供自动备份。请定期手动备份:

  1. 关机,确保世界已保存。
  2. 在「文件管理」中勾选 world(以及 world_nether、world_the_end 等)目录,点「下载」,目录会先压缩再下载。
  3. 也可以使用 SFTP 直接下载整个目录。

也可以自行安装定时备份类插件或模组,把备份保存在实例磁盘上,但要留意磁盘空间。

怎么重置世界

关机后在「文件管理」中删除或重命名 world 等世界目录,再开机即可生成新世界。需要指定种子时,先在「环境变量」中填写「世界种子」。

实例到期后文件还在吗

实例到期后状态为「已到期」,文件变为只读,仍可浏览和下载,但不能修改或安装资源,续费后恢复。到期后的保留期限和续费规则见 计费续费与到期。

关机很慢

「关机」会先发送 stop 命令让服务端保存世界再退出,世界较大或模组较多时需要一些时间,请耐心等待。确实卡死时再使用「强制停止」,它会直接结束进程,未保存的数据可能丢失。