安装时提示「数据库连接失败」
- 确认 MySQL 服务在运行。
- 打开
application/database.php核对库名、用户名、密码、主机地址。 - 主机地址写
127.0.0.1或localhost，别写服务器公网 IP。 - 密码含特殊字符（如
@、#）时要用单引号包裹。
提示「runtime 目录无写入权限」
chmod -R 755 runtime/
chown -R www:www runtime/同时确认没有 SELinux 拦截。
提示缺少 fileinfo 等扩展
宝塔 → PHP 设置 → 安装扩展 → 装 fileinfo，装完重启 PHP 服务。命令行环境：yum install php-fileinfo 或 apt-get install php7.4-fileinfo。
前台白屏 / 500
- 先看错误日志：
/www/wwwlogs/你的域名_error.log。90% 是memory_limit小于 256M 或缺 gd 扩展。 - 开 debug 定位具体文件：
/application/extra/config.php里debug改true。 - 模板与程序版本不兼容也会白屏，换模板试试。
后台登录：密码对但一直跳回登录页
- session 目录权限不足：清空
runtime下所有文件（保留 index.html），再chmod -R 777 runtime。 - 开了 opcache 或 Redis 的，也清一次缓存。
- 验证码无限报错：打开
config/verify.php，把模式从 image 改成 gd（需装 gd 扩展），或把'verify' => true改成false关掉验证码。 - 还不行就检查 PHP 版本，降级到 7.4。
采集无数据 / 采到 0 条
- 先用浏览器打开接口地址，确认能返回数据。
- 目标站反爬：修改请求头 UA，或换接口。
- 接口方式选错：资源站是 JSON 就选 JSON，XML 就选 XML。
采集到了但播放不了 / 解析失败
- 检查播放器编码是否与接口来源标识完全一致（如
zkm3u8）。 - 解析接口失效：换几个公用的解析地址测试。
- 源站防盗链：把播放器的 referer 设成你的域名。
- CDN 要放行
.m3u8、.ts、.mp4等后缀，并配置好 CORS 头。
搬家后出问题
- 网站根目录变了：检查
application/extra/template.php里view_path是否指向正确模板目录。 - 乱码：数据库字符集与页面字符集不统一，统一用 utf8mb4。
- 换了服务器：核对
application/database.php里的数据库信息。