苹果CMS搬家后正式域名切换，5大高频报错与实操指南

数据抓取全部失败

报错现象：
搬家到新域名后，执行“一键采集”或“自定义采集”，所有资源站返回“采集失败”，任务队列无数据，日志显示“无法连接资源服务器”或“HTTP请求超时”。

原因分析：
苹果CMS的采集接口通常绑定了旧域名或IP白名单，搬家后旧域名解析中断，而新域名又未被资源站服务器识别，更隐蔽的原因是采集插件内部写死了旧域名路径，或伪静态规则未适配导致请求被302重定向到旧地址。

解决步骤：

修复采集接口域名：
打开 application/database.php，检查 DB_HOST 是否仍为旧IP，如果资源站要求域名白名单，需联系资源站管理员将新域名加入白名单。
修改采集器配置：
进入后台“采集管理”->“自定义资源库”，每一条资源的“采集地址”如果包含旧域名，手动替换为 https://新域名，批量操作可用SQL替换：
```
UPDATE `mac_collector` SET `collector_url` = REPLACE(collector_url, '旧域名', '新域名');  
```
清理采集缓存：
删除 runtime/cache/ 和 runtime/temp/ 下所有文件，重启PHP-FPM。
测试单条采集：
在后台“资源库管理”点击某条资源的“测试采集”，返回200状态码即为成功。

报错现象：
影视详情页可正常显示简介，但播放器区域一直转圈，控制台报错 Uncaught TypeError: Cannot read property 'play' of undefined，或显示“播放器初始化失败，请检查flash”。

原因分析：
典型的跨域或资源路径错误，搬家后播放器JS/CSS文件引用了旧域名的CDN地址，或者新域名未配置SSL导致HTTPS混合内容被浏览器拦截，部分自建播放器（如dplayer、ckplayer）的配置文件硬编码了旧地址。

解决步骤：

检查播放器资源引用：
打开页面F12查看网络请求，过滤“player”关键字，若看到旧域名请求被301/302重定向，说明主题的播放器地址写死了。
修复主题配置：
进入后台“主题管理”->“当前主题”->“自定义配置”，找到“播放器地址”或“解析接口”，改为新域名，如果未提供配置项，直接修改主题文件：
- 查看 /template/你的主题/html/player/ 下的 player.html，搜索旧域名并替换。
启用HTTPS全站跳转：
在 nginx.conf 或 .htaccess 中强制HTTP跳转HTTPS，避免播放器混合内容报错。
清空浏览器缓存：
强制刷新（Ctrl+F5）或浏览器无痕模式测试避免本地缓存干扰。

报错现象：
输入账号密码后页面刷新但依然停留在登录页，或者跳转到 admin.php?c=index 后直接白屏，部分浏览器显示“服务器内部错误”。

原因分析：
搬家后数据库连接被修改但session表损坏，或者 data/conf/common.php 中的授权验证文件路径指向了旧域名，更常见的原因是.env文件中APP_URL未更新导致回调地址异常。

解决步骤：

重置管理员密码：
直接操作数据库：

UPDATE `mac_admin` SET `admin_pwd` = 'e10adc3949ba59abbe56e057f20f883e' WHERE `admin_id` = 1;

密码变为 123456，登录后立即修改。

修复授权验证文件：
检查 application/extra/ 下是否存在 auth.php 或 license.php包含旧域名，替换为新域名。
清理session：
删除 runtime/session/ 目录下所有文件，并重启web服务。

检查.htaccess或nginx伪静态：
确保伪静态规则正确，特别是 admin.php 的RewriteRule未被拦截，示例nginx规则：

location / {  
    try_files $uri $uri/ /index.php$is_args$args;  
}  
location /admin {  
    try_files $uri /admin.php$is_args$args;  
}

报错现象：
访问任何页面都显示纯白背景，无任何HTML输出，浏览器状态码200，或所有中文显示为乱码，类似“æˆ‘çš„ç½‘ç«™”。

原因分析：
最常见的两种原因：

解决步骤：

修复字符集乱码：
检查数据库配置 application/database.php：
```
'charset' => 'utf8mb4',  
'collation' => 'utf8mb4_unicode_ci',  
```
如果原数据库是utf8，则改回'charset' => 'utf8'，避免字符集错误。
检查PHP错误报告：
在 index.php 开头加入 error_reporting(E_ALL); ini_set('display_errors', 1); 查看具体报错，常见为“Class 'app\common\controller\All' not found”，说明文件丢失或路径不匹配。
重建伪静态规则：
后台“系统”->“URL配置”->“重新生成伪静态规则”，并将生成的文件替换到Web服务器配置中。
检查文件权限：
确保 runtime/ 目录及其子目录有777写权限，PHP用户能读取所有站点文件。

报错现象：
重新运行安装程序（访问 /install/ 或 /install.php）时，环境检测页面红叉显示“PHP版本需≥5.6”、“curl扩展未启用”或“openssl未加载”。

原因分析：
搬家到新的服务器或PHP版本环境后，未适配原CMS的依赖项，有时新主机默认禁用某些函数（如 file_get_contents），导致采集和播放器失效。

解决步骤：

检查PHP实际版本：
创建临时文件 info.php为 <?php phpinfo(); ?>，访问查看PHP版本和加载的扩展，如果CMS要求7.0但服务器为5.6，需联系主机商升级。
手动安装缺失扩展：
对于Debian/Ubuntu系统：
```
sudo apt install php7.4-curl php7.4-openssl php7.4-mbstring php7.4-mysql  
```
或修改php.ini去掉扩展注释 ;extension=curl，重启PHP后再次检测。
修改CMS版本检查绕过：
如果只是PHP小版本差异（如要求7.0但实际7.1），编辑 install/install.php，找到版本判断函数，将 version_compare(PHP_VERSION, '7.0.0', '<') 改为 version_compare(PHP_VERSION, '5.6.0', '<')。
彻底重装避免后续报错：
建议备份数据库和 application/database.php，然后删除 install.lock 文件，重新执行安装流程，期间环境检测会强制提示更换，完成后恢复数据库和配置即可。

后记：苹果CMS搬家后，80%的报错源于域名硬编码和伪静态规则失效，建议每次搬家用脚本全局搜索旧域名并批量替换（排除runtime/目录），再逐项检查以上5类问题，基本可以零报错上线。