苹果CMS搬家数据库修改全攻略，从报错到修复的实战指南

无法连接数据库或采集源失效

报错现象： 搬家后进入后台采集页面，点击“开始采集”时提示“数据库连接失败”或“采集接口返回空数据”，部分情况下直接跳转至404页面。

原因分析： 苹果CMS的采集模块依赖两个核心配置：一是application/database.php中的数据库连接参数，二是application/extra/collect.php或后台采集自定义配置中的资源站接口地址，搬家后若数据库名称、用户名或密码发生变更，但配置文件未同步修改，采集模块就会因无法读取采集规则和资源站配置而报错。

解决步骤：

打开application/database.php，核对hostname、database、username、password四项参数是否与新服务器数据库一致，特别注意：部分虚拟主机要求hostname填写localhost而非IP。
登录phpMyAdmin,检查mac_collect和mac_collect_rule表是否存在，若搬家时只导出了部分表，需重新导入完整数据库。
进入后台“采集”->“自定义采集”，逐条检查资源站接口地址，若资源站已更换域名，需同步更新，建议直接删除旧规则，重新添加。
若报错“Allowed memory size exhausted”，说明采集数据量过大，在php.ini中将memory_limit调整为256M。

播放器无法加载：JS/CSS路径错误或跨域拦截

报错现象： 视频详情页播放器区域空白，F12控制台显示“Failed to load resource: the server responded with a status of 404”或“Blocked by CORS policy”。

原因分析： 苹果CMS的播放器依赖/static/player/目录下的JS文件，搬家后若网站域名变更，而数据库mac_config表中site_url字段仍为旧域名，系统会生成错误的资源引用路径，若新服务器未开启伪静态，播放器请求的/index.php/ajax/player接口会返回404。

解决步骤：

进入后台“系统”->“网站配置”，将“网站域名”修改为新域名，保存后清空缓存（后台右上角“清空缓存”）。
检查/static/player/目录是否存在且权限为755，若搬家时遗漏该目录，从原站打包上传。

在Nginx配置中添加伪静态规则：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}

若控制台报CORS错误,在index.php顶部添加：
```
header('Access-Control-Allow-Origin: *');
```

后台登录异常：验证码不显示或账号密码错误

报错现象： 输入正确账号密码后提示“验证码错误”，或验证码图片显示为红叉，或登录后无限跳转回登录页。

原因分析： 验证码依赖GD库和Session存储，搬家后若PHP版本升级（如从5.6升至7.4），GD库可能未安装；若Session目录权限不足，验证码无法写入，数据库mac_admin表中的密码若因搬家时字符集转换错误（如utf8转utf8mb4），会导致哈希值不匹配。

解决步骤：

在phpinfo页面搜索“gd”，确认GD库已开启，若未开启，在宝塔面板“软件商店”->“PHP设置”->“安装扩展”中安装GD。
检查/runtime/目录权限，设为777（Linux）或给IIS_IUSRS读写权限（Windows）。
若密码错误,用phpMyAdmin打开mac_admin表，将admin_pwd字段值临时改为e10adc3949ba59abbe56e057f20f883e（对应密码123456），登录后立即修改。
若登录后跳转回登录页,删除/application/admin/controller/Login.php中session_start()前的BOM头。

页面空白或乱码：编码冲突与模板路径错误

报错现象： 前台首页空白，或显示“锘匡拷”等乱码字符，或仅显示“{maccms:...”标签未解析。

原因分析： 搬家时若用记事本编辑过配置文件，可能引入UTF-8 BOM头，导致PHP输出头信息后无法解析模板，数据库字符集若从utf8改为utf8mb4，但连接配置未同步，会读取乱码。

解决步骤：

用Notepad++打开application/database.php，点击“编码”->“转为UTF-8无BOM格式”，保存。
在数据库连接参数中添加'charset' => 'utf8mb4'。
检查/template/目录下模板文件夹名称是否与后台“系统”->“模板配置”中一致，若搬家时重命名了文件夹，需同步修改。
若标签未解析,进入后台“系统”->“缓存管理”，点击“更新模板缓存”。

安装环境检测不通过：缺少扩展或目录不可写

报错现象： 访问/install/index.php时，环境检测页面显示“PHP版本过低”或“/runtime/目录不可写”。

原因分析： 苹果CMS要求PHP 7.0以上，且需开启fileinfo、curl、mbstring等扩展，搬家后若新服务器为默认配置，往往缺少这些扩展，目录权限问题多因Linux下所有者与运行用户不一致。

解决步骤：

在宝塔面板“软件商店”->“PHP设置”->“安装扩展”中，安装fileinfo、curl、mbstring、openssl。

执行命令修改权限：

chown -R www:www /www/wwwroot/你的网站目录
chmod -R 755 /www/wwwroot/你的网站目录
chmod -R 777 /www/wwwroot/你的网站目录/runtime

若仍提示不可写,检查SELinux状态，临时关闭：setenforce 0。
安装完成后,务必删除/install/目录，防止被恶意重装。

搬家本质是“数据+环境+配置”的三重迁移，苹果CMS的数据库修改只是第一步，真正棘手的是那些依赖路径、权限和扩展的隐性问题，按上述五类问题逐一排查，90%的搬家故障都能在10分钟内解决，若仍报错，建议打开application/common.php中的调试模式，查看具体SQL错误——那通常就是答案。