YikaiCMS Beginner Guide
备份、升级与排错
了解数据库和文件备份、升级前检查，以及栏目 404、页面 500、缓存和上传失败的排查顺序。
← 返回教程总览
备份、升级与常见问题
先备份，再升级
- 进入“系统设置 → 数据库”执行备份。
- 另外保存
config.php、uploads/、storage/和自定义主题、插件。 - 确认项目使用 PHP 8.2 或更高版本，ZipArchive、OpenSSL、网络下载和目录写入检查通过。
- 升级完成后运行数据库升级，再打开首页、栏目页、文章详情和后台。
在线升级主要覆盖程序文件；配置、上传文件和运行数据按升级提示保留，核心改动要单独留存差异。
小白排错顺序
页面 404
检查站点 URL、栏目状态、伪静态配置和别名冲突。
页面 500 或空白
确认 PHP 版本和扩展，再查看服务器与 CMS 错误日志。
修改后没变化
确认已经保存并发布，打开正确语言版本，必要时清理缓存。
上传失败
检查 uploads/ 权限、PHP 上传限制、格式和磁盘空间。