Minecraft Java升级演练与回退
服务器能启动,不代表升级已经完成。世界格式、Java版本、插件和玩家资料都可能受到影响。本文处理同一服务端类型的版本升级,例如原版升原版、Paper升Paper;不把原版转Paper、整合包更换或基岩版迁移混在一起做。
先记录一套可还原的版本清单
| 项目 | 要记录的内容 |
|---|---|
| 服务端 | Minecraft版本、服务端类型、构建号及实际启动文件。 |
| Java | 启动脚本或服务实际使用的Java路径与版本,不能只看另一个终端的默认Java。 |
| 扩展 | 插件、数据包或模组版本,以及明确支持的目标版本。 |
| 数据与依赖 | 世界位置、外部数据库、权限和其他会被插件访问的服务。 |
Java要求要按目标版本核对。例如Minecraft Java 26.1已要求Java 25,不能继续套用所有版本都装Java 21的旧说法。升级世界也可能改变内部目录结构,不要按旧目录名手工删掉新生成的数据。
正常停服后保留升级前的整套副本
- 通知玩家维护时间,停止新玩家进入。在游戏服务端控制台使用
stop正常停服,等待保存完成和进程退出。 - 确认自动拉起程序没有重新启动游戏。将完整服务端目录另存到带时间的新位置,保留所有世界、配置、扩展及原启动脚本。
- 插件使用外部数据库时,按其方法同时备份;只复制游戏目录不能覆盖这些数据。
- 核对备份可读取,保留在生产目录之外。原服务端和旧Java运行环境也要能重新取得,不能只留下一个世界压缩包。
在隔离副本上试升级
- 从备份建立一个独立测试目录,使用不同端口并限制只有测试人员能连接,不与正式目录共用世界文件。
- 检查插件的数据库、缓存、Webhook等连接,切到测试依赖或按插件支持的方法停用外联,避免副本写入生产数据。
- 从对应服务端项目的可信发布渠道取得目标版本,先核对Java和扩展兼容性,再调整测试启动脚本。不要在仍运行的进程下面替换JAR。
- 启动测试服,保存启动日志。等待世界加载或格式转换完成,不因第一次启动较慢就立即强制结束。
- 使用匹配版本的客户端进服验收,再正常停服、重启测试一次。
验收要覆盖哪些内容
至少检查原基地、常用维度、玩家背包与末影箱、权限、常用插件功能,以及保存后重启是否仍保持变化。插件显示已加载,只说明加载阶段通过,还要用普通玩家身份测试实际功能。出现缺少内容、数据包错误或世界读取失败时,先保留日志,不让玩家在异常版本里继续推进进度。
正式切换与失败回退
测试通过后再约定正式维护。再次停服并制作最新备份,按已经验证的步骤升级;不能把几天前的测试世界直接覆盖正式世界,丢掉期间的新进度。
需要回退时,先停止升级后的服务端,另外保存本次运行留下的世界、日志和数据库状态。然后恢复升级前同一时间点的世界、配置、扩展和匹配的旧服务端。不要仅换回旧JAR,再让旧版本打开已经转换过的世界。
如果开放升级服后玩家已产生新进度,回退会回到备份时间点。先记录这段新增数据并说明影响,再决定恢复;不能承诺把不同版本的世界文件简单拼接就能无损合并。
相关文档:Minecraft Java首次开服 · 安全恢复备份 · 游戏服启动后无法连接。