MineWiki
Java 版开服教程扩展内容插件

更新插件并安全回滚

每次只更新可验证的部分,保留旧版本和配置,避免在高峰期直接替换 jar

插件更新可能修复漏洞、兼容新版本或增加功能,也可能改变配置格式和权限节点。真正安全的更新不是“看到新版就覆盖”,而是先知道自己要更新什么、如何验证,以及失败后怎么回到上一版。

更新前先确认四件事

检查项要问的问题
来源文件是否来自作者声明的发布页?校验和、版本号和发布日期是否合理?
兼容性是否支持当前 Minecraft、Paper、Java 与依赖插件版本?
变更发行说明是否提到配置迁移、破坏性变更或数据转换?
回滚旧 jar、旧配置和整服备份是否都可用?

来源不明的“汉化整合版”“一键破解器”不应进入生产服。插件会在服务端进程中执行,下载渠道和文件完整性与功能本身同样重要。

两种可控的更新方式

Paper 支持在 plugins/update/ 中放置待更新插件,服务端重启时会应用这些 jar。这可以避免在运行时直接替换正在加载的插件文件,但仍应先确认插件之间兼容。1

另一种方式是:正常停服后替换单个 jar,再启动验证。无论采用哪种方式,都不要在服务端运行时随意删除或覆盖插件 jar。

推荐流程如下:

  1. 正常停服并创建整服备份。
  2. 保存旧 jar 和对应配置,给目录或文件加上版本与日期标记。
  3. 一次只更新一个高优先级插件或一组存在明确依赖关系的插件。
  4. 启动后检查 logs/latest.log,再用普通玩家和管理员账号测试核心功能。
  5. 观察一段时间后再更新下一项;若出现问题,先停服并恢复匹配的旧 jar 与配置。

什么情况下应立即停止

出现配置被自动重写、数据库迁移失败、权限突然扩大、启动日志不断重复异常,或玩家核心数据无法读取时,不要继续“多更新几个试试”。保留日志、停服、恢复到已知可用的版本组合,再查发行说明和插件官方支持渠道。

回滚不是只换回 jar

有些更新会同时更改配置、数据文件或数据库结构。回滚时应尽量恢复同一时间点的 jar、配置和数据副本。只把 jar 换回旧版却保留新版生成的数据,可能制造新的兼容错误。

参考

On this page