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)」
服务器占用的内存超过了套餐上限。可以:
- 升级套餐 增加内存。
- 在「环境变量」中调小「视距」和「模拟距离」。
- 精简模组或插件,减少同时在线人数。
默认启动参数会让 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 版本
- 先关机并备份世界目录。
- 在「环境变量」中修改核心版本(例如「Paper版本」),点「保存变量」。
- 如果新版本要求更高的 Java,在「启动设置」中切换运行镜像。
- 点击「重新安装」,安装完成后手动开机。
存档只能升级不能降级,降级后可能无法加载。要换成另一种核心(例如 Paper 换成 Forge)需要使用「切换游戏」,会清空数据目录,见 重新安装与切换游戏。
重新安装会删除我的存档吗
不会。「重新安装」会先关机,然后重新运行安装脚本,数据目录中的文件会保留,但脚本可能覆盖其中的同名文件(例如服务端核心)。整合包实例会重新解压整合包,覆盖同名的配置文件。操作前仍建议备份。
控制台输入命令要加斜杠吗
不需要。在「控制台」底部输入框直接输入 op 玩家名、whitelist add 玩家名 等,按 Enter 发送,用 ↑/↓ 可以翻看历史命令。服务器未运行时无法输入命令。
连接
玩家连不上服务器
- 确认实例为「运行中」,且控制台已出现启动完成提示。
- 确认使用的是「概览」标签「玩家连接地址」中的完整地址,端口是自动分配的外网端口,不是 25565。
- 确认客户端版本和服务端一致;模组服需要安装相同的模组。
- 非正版账号需要在「环境变量」中关闭「正版验证」。
完整的排查表见 玩家如何连接服务器。
基岩版客户端更新后进不去
基岩版客户端只能连接不低于自身版本的服务端。在「环境变量」中把「Bedrock版本」改为「官方最新版」或更高的版本,保存后「重新安装」,安装完成后开机。重装会保留 server.properties、permissions.json、allowlist.json。
存档与数据
平台会自动备份存档吗
平台暂不提供自动备份。请定期手动备份:
- 关机,确保世界已保存。
- 在「文件管理」中勾选
world(以及world_nether、world_the_end等)目录,点「下载」,目录会先压缩再下载。 - 也可以使用 SFTP 直接下载整个目录。
也可以自行安装定时备份类插件或模组,把备份保存在实例磁盘上,但要留意磁盘空间。
怎么重置世界
关机后在「文件管理」中删除或重命名 world 等世界目录,再开机即可生成新世界。需要指定种子时,先在「环境变量」中填写「世界种子」。
实例到期后文件还在吗
实例到期后状态为「已到期」,文件变为只读,仍可浏览和下载,但不能修改或安装资源,续费后恢复。到期后的保留期限和续费规则见 计费续费与到期。
关机很慢
「关机」会先发送 stop 命令让服务端保存世界再退出,世界较大或模组较多时需要一些时间,请耐心等待。确实卡死时再使用「强制停止」,它会直接结束进程,未保存的数据可能丢失。
