站点维护
常见故障排查
按白屏、404、数据库连接、模板缓存和播放失败分类，查找 MacCMS 故障的第一步、日志位置与恢复方法。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
先记录「哪个地址、做了什么、看到什么错误」，再改一个设置。把同一问题同时归因于 PHP、模板、数据库，会让排查更困难。
先取得错误证据
电脑浏览器按 F12（Mac 可用开发者工具菜单），切到 Network／网络，重新整理页面，点击红色请求，记下状态码和响应内容。截图时遮住 Cookie、令牌与账号信息。
PHP 错误查看面板中此站的错误日志；程序日志在启用记录时通常位于 runtime/log。没有日志文件不代表没有错误，应同时查 Web 服务与 PHP 服务日志。
| 现象 | 第一检查 | 下一步 |
|---|---|---|
| 安装白屏／500 | PHP 版本、扩展、runtime 权限及 PHP 日志 | 按环境清单逐项修复 |
| could not find driver | 网站 PHP 的 pdo_mysql | 装对版本的扩展并重载该 PHP 服务 |
| 数据库连接失败 | database.php 中的主机／端口／库名／账号 | 容器里的 127.0.0.1 不是数据库容器 |
| 只有首页正常，其余 404 | 带 index.php?s= 的地址是否可用 | 可用则检查伪静态规则 |
| 模板文件不存在 | 报错显示的模板路径 | 检查模板选择、目录层级、文件大小写 |
| 分类无权限 | 游客及会员组分类权限 | 授予应有访问范围再测试 |
| 表单提示令牌错误 | 页面是否过期、JS／令牌是否加载 | 刷新表单，检查同源 Cookie 和默认模板实现 |
| 播放失败 | 媒体请求状态与真实内容 | 403 查来源限制；404 查地址；200 仍需确认返回媒体而非 HTML |
改模板后没有变化
- 先核对正在使用的模板名称，别改到另一套模板。
- 后台使用缓存管理清理本站模板缓存，不要清其他站点的缓存服务。
- 纯静态模式需要重新生成对应页面；清模板缓存不会重写已生成 HTML。
- 浏览器强制刷新；若用了 CDN，再对具体受影响 URL 刷新缓存。
- PHP 配置刚修改但仍读取旧值时，检查 OPcache 更新周期，必要时重载本站 PHP 服务。
向维护者提供什么
提供程序版本、PHP 版本、出错路径、操作步骤、完整错误文字和脱敏日志片段。不要发送整份配置或数据库密码。涉及升级先对照备份与恢复。