从备份恢复CraftCMS 3后出现HTTP 503服务不可用异常求助

1. 强制关闭维护模式 #

CraftCMS的ServiceUnavailableHttpException多数和维护模式未正常关闭有关，即使恢复备份也可能残留状态：

• 终端进入项目根目录，执行命令：./craft app/maintenance/off
• 无控制台权限的话，直接修改数据库：找到craft_systemsettings表，将maintenanceMode字段值改为0

2. 修复文件权限 #

备份上传后权限配置易出错，导致Craft无法访问关键目录：

• 确保storage/、vendor/、web/目录权限为755，文件权限为644
• 确认服务器运行用户（如www-data）对这些目录拥有读写权限

3. 清除缓存与生成资源 #

残留缓存会和备份内容冲突，引发服务不可用：

• 删除storage/runtime/下所有文件及子目录（保留runtime目录本身）
• 删除web/cpresources/下全部内容，让Craft重新生成前端资源

4. 核对数据库连接配置 #

服务器端数据库配置可能和本地不一致：

• 检查.env（或config/db.php）中的数据库主机、用户名、密码、库名是否正确
• 用终端命令mysql -u [用户名] -p [数据库名]测试连接是否正常

5. 查看详细错误日志 #

日志能定位具体故障点：

• 打开storage/logs/web.log和storage/logs/craft.log，查找503错误前后的具体报错信息
• 若日志无法写入，先调整storage/logs/目录权限为可写

6. 重新安装Composer依赖 #

vendor/目录文件可能在上传中损坏：

• 项目根目录执行composer install，重新拉取完整依赖（需服务器有Composer环境）
• 无Composer权限的话，重新上传本地完整的vendor/目录，同步权限配置

内容的提问来源于stack exchange，提问作者Jeff Fulton