先给结论
插件问题经常不是单个插件坏了,而是核心、Java、依赖库和插件版本组合不再兼容。用版本清单锁定当前可用组合,再按依赖顺序升级,比遇到报错才临时下载最新文件更稳。
执行步骤
- 记录服务端核心构建、Java 版本、每个插件版本、依赖插件和配置格式版本。
- 把插件分为核心依赖、玩法、管理和装饰四类,优先识别会影响大量功能的基础插件。
- 升级时先升级兼容性要求最明确的核心和依赖,再升级上层玩法插件,单次只改变一组相关组件。
- 把成功组合写入版本清单,并保留下载来源、发布日期和回滚文件。
验收标准
- 重启后没有重复的依赖缺失、方法不存在或版本不兼容错误。
- 关键命令和事件均通过测试,插件列表状态与预期一致。
- 下一次升级可以从清单直接恢复当前稳定组合。
常见误区
- 看到最新版本就全部更新,忽略服务端核心和 Java 的支持范围。
- 只备份插件 jar,不备份配置和依赖版本清单。
建议先在测试服完成验证,再安排线上维护窗口;每次只改变一组相关变量,并保留可回退的配置和数据副本。