MacCMS 常见问题
这里是速查版，一句话说清。每类问题的完整"症状 → 原因 → 解决"写在部署排障大全里，装站前后遇到报错优先翻那页。安全相关的看安全加固。
安装相关
数据库连接失败
查 /application/database.php，确认 hostname / database / username / password / hostport 填对、数据库已创建。详见排障。
除首页外都是 404
伪静态没配。Nginx、Apache 两套规则见排障。
如何重新安装
删掉安装锁文件 /application/data/install/install.lock，重新访问域名即可。
PHP 8 下报类型错误
ThinkPHP5 和 PHP 8.x 不太合，建议换 PHP 7.x。见排障。
采集相关
采集后没数据
多半是分类没绑定，或资源站本来就没这个分类的数据。排查步骤见排障。采集流程本身看采集教程。
采集速度慢
首次全量采集慢是正常的，之后只采当天就快了，别在高峰期采。
接口相关
接口返回空数据
先确认库里有数据，再测 /api.php/provide/vod/?ac=videolist。见排障。
跨域（CORS）
App 取不到数据常是跨域没放开，服务器加 Access-Control-Allow-Origin 等头。见排障。
后台相关
后台打不开，提示"请将 admin.php 改名"
这是源码的强制要求，不是报错。admin.php 里写死了检查：只要还用 admin.php 访问后台就会被直接拦下、进不去。必须把 admin.php 改成别人猜不到的文件名（如 admin7854.php），再用新文件名访问。详见排障。
忘记后台地址
改过名后，后台地址是"域名 + 你自己起的那个 xxx.php"，在网站根目录能找到这个文件。注意不能再用默认 admin.php——源码会强制拦截。
忘记管理员密码
从数据库直接改，或删 install.lock 重装。