更新卡住或报错，先看具体提示。站点慢、白屏、后台进不去，基本都是同一套排查路径，掌握一次就够用。

下面按“先判断范围、再处理、最后防复发”的顺序展开，涉及 插件更新、权限 的关键动作都给了具体做法，可以照着走。

空间

磁盘满或 inode 满。

优先选可回退的方案，别用一次性操作换速度。

权限

文件属主是否与运行账号一致。

容易踩的坑：另一个坑是照抄别人的参数，环境不同，参数就该重新算。

网络

连接官方源超时。

拿不准的时候先做备份再做变更，成本最低。

手动

下载 zip 上传安装。

常见问题

Q：插件更新这类问题，最快的判断办法是什么？
先确认现象的范围：只有单台还是全部、只在某个时段还是持续。范围一缩小，原因基本就浮出来了。

Q：按文中的步骤做完，还需要注意什么？
把处理过程和最终生效的参数记下来。同类问题再出现时直接对照记录，比重查一遍快得多。

小结

回到这篇的四个环节：空间、权限、网络、手动。把上面几步存成一张检查表，下次同类问题照着走就行。

相关阅读：主题更新失败怎么办、后台报 502 怎么回事、前台报 500 怎么查。