WordPress 维护模式卡死：三步退出法

WordPress 更新插件或核心时，如果页面突然中断、服务器超时，前台和后台都可能只显示一行英文：Briefly unavailable for scheduled maintenance. Check back in a minute. 这行字来自站点根目录下的 .maintenance 文件。更新正常结束时 WordPress 会自动删除它；一旦进程被中断，文件就可能留下来，站点就会一直卡在维护模式。

为什么会卡在维护模式

WordPress 在开始更新前会往站点根目录写一个 .maintenance 文件，里面只有一段 PHP 代码用来加载维护提示页。更新完成后系统会尝试删除它。以下情况容易让它残留：

• 更新过程中浏览器被关闭或网络断开；
• 服务器 max_execution_time 太短，导致更新脚本被强制终止；
• 同时更新多个插件/主题，某个任务失败；
• 缓存层（CDN、对象缓存）把维护页缓存了很久。

/var/www/html/.maintenance
/home/wwwroot/yoursite/.maintenance
/public_html/.maintenance

退出维护模式三步法

1. 用 SFTP 或 SSH 连到站点根目录

如果你用宝塔，进入「文件」→ 站点目录；如果用手动 VPS，SSH 登录后 cd 到网站根目录。

cd /var/www/html
ls -la | grep maintenance

2. 删除 .maintenance 文件

这是唯一的恢复动作。删除后刷新页面，站点就应恢复正常。

rm -f .maintenance

如果是宝塔面板，也可以直接在文件管理器里右键删除 .maintenance。

3. 清缓存再访问

删除文件后，如果还看到维护提示，大概率是缓存：

• 浏览器：按 Ctrl + Shift + R 或打开无痕窗口；
• CDN（Cloudflare 等）：开「开发模式」或清缓存；
• 对象缓存（Redis/Memcached）：执行 wp cache flush 或重启缓存服务。

踩坑实录

去年帮一个朋友处理过一个典型情况：他在一台月付 3.5 刀的共享主机上点了一键更新 WooCommerce，页面转了几分钟后变白，随后整站显示维护提示。我进 SFTP 看到 .maintenance 文件还在，时间戳是 20 分钟前的。

当时先删了文件，站点恢复。但重新更新时又卡住了。查 PHP 错误日志发现 Fatal error: Maximum execution time of 30 seconds exceeded。主机面板把 max_execution_time 锁死在 30 秒，没法改。最后只能手动用 WP-CLI 更新：

wp plugin update woocommerce --allow-root

整个更新过程不到 10 秒，之后再也没卡过维护模式。这个坑说明：共享主机的资源限制是更新中断的常见元凶，必要时直接用命令行更新更稳。

避免再卡的三个习惯

• 先备份再更新。 用 UpdraftPlus 或主机快照备份数据库和文件，更新失败也能回滚。
• 不要在高峰期批量更新。 一次只更新一个插件或主题，出问题容易定位。
• 提高 PHP 执行限制。 如果是自己的 VPS，在 php.ini 里把 max_execution_time 设为 300，memory_limit 设为 256M 或更高：

max_execution_time = 300
memory_limit = 256M

常见问题

Q：删除 .maintenance 后后台还是进不去？
A：多半是某个插件更新到一半损坏了。把 /wp-content/plugins/ 里最近更新的插件文件夹重命名，逐个启用排查。

Q：WordPress 多站点也会卡维护模式吗？
A：会。.maintenance 文件在根目录，整网都会受影响，处理方式一样。

Q：能不能彻底禁用维护模式？
A：不建议。维护模式是保护机制。可以通过代码把提示页换成中文，但不要完全关闭，否则更新时用户可能看到半成品页面。

如果你也遇到过 WordPress 更新后卡在维护模式的情况，欢迎在 fenij.com 留言，说说你是怎么解决的。