周五晚上八点开始升级，核心包二十分钟装完，首页正常，登录正常。周一早上第一节课，教师发现证书插件打不开，学生领不到证书。排查下来，插件只支持到上一个分支，核心升级后它的升级脚本没跑完。类似的事故，多数出在插件和主题，不在核心。
一、分支覆盖：先确认插件支持目标版本
把站点当前使用的插件列出来，逐个核对支持分支。以目标分支 5.3 为例，插件声明只到 5.2，就按「未验证」处理，不要抱着试试看的心态直接上生产。目录的按分支筛选可以先筛出兼容 5.3 的条目，再和站点插件清单对一遍。
只标一个分支的条目要单独标记。它可能只在那一个版本上测试过，也可能作者没更新声明。两种情况都要在测试站装一遍，确认课程页、成绩页和计划任务没有报错，再决定是否保留。
二、插件停更：最近一次发布是什么时候
看版本时间线比看简介有用。最近一次发布在两年以前，之后没有针对新分支的版本，基本可以按停更处理。站点数高不代表还在维护，老牌插件同样可能停在旧分支。停更插件不一定要马上删，先确认它是否还在关键路径上：证书、成绩、选课这类环节，风险比一个装饰性版块高得多。
找不到替代品时，把风险写进升级方案：谁负责验证，出问题怎么降级，最长能接受停多久。写清楚比口头说「应该没事」有用。
三、主题兼容：别把主题留到最后
主题也依赖核心模板。自定义子主题、模板覆盖和额外 CSS，在核心升级后都可能错位。升级前确认主题支持目标分支，列出改过模板文件的地方，升级后在桌面和手机各看一遍首页、课程页和测验页。
主题目录里的条目同样标了支持分支，可以从主题目录核对。用第三方主题的站点，先看作者有没有发布兼容版本；没有的话，准备一个默认主题作为回滚方案。
四、备份与回滚：确认能回去
备份要覆盖四样东西：数据库、moodledata 目录、插件源码、主题的自定义改动。只备份数据库不够，moodledata 里的课程文件和插件产生的缓存同样要能恢复。备份完做一次恢复演练，确认文件权限和数据库连接都正常。
旧版本的插件包提前留在手上。作者可能在新版发布后撤掉旧包，等出事再下载就晚了。升级窗口留出一个工作日缓冲，指定一个人能拍板停手，避免一边报错一边继续点下一步。
五、升级后回归：24 小时内看什么
先看登录和课程页，再看测验提交、成绩册计算、证书下载这三条高频链路。计划任务和日志也要看，插件升级引发的问题常常在夜间任务里出现。手机端单独走一遍，主题和编辑器在窄屏上最容易出问题。
升级完成后清一次缓存，记录升级前后的响应时间。有监控的站点把首页和课程页加进监控，没有监控的，手动打开三次记下大致秒数。第二天早上再复查一次，教师反馈往往集中在这个时间。
六、把清单落成一张表
- 分支覆盖：目标分支、插件支持区间、未覆盖名单；
- 插件停更：最近发布日期、是否有新分支版本、替代方案；
- 主题兼容：主题版本、模板改动、移动端检查结果；
- 备份回滚：备份完成时间、恢复演练结果、旧包位置；
- 升级后回归：登录、课程、测验、成绩、证书、计划任务。
五项都填完，再决定是否在当晚升级。任何一项填不出来，都说明准备还不够。插件目录的条目页把支持分支和最近发布放在首屏，核对时比翻仓库快；清单不用长，能照着执行就行。
