苹果CMSV10采集标题错乱全场景修复实操指南 零门槛可落地

本指南仅适用于苹果CMSV10正式版，所有操作均为实测可落地步骤，操作前请做好备份。

前置准备工作

操作前请提前准备好以下权限，避免中途卡壳：

• 苹果CMS后台超级管理员权限
• 服务器FTP/宝塔面板文件管理权限
• 数据库管理权限（宝塔phpMyAdmin或其他数据库工具）

重要提醒：操作前务必先备份全站数据库与即将修改的源码文件，避免操作失误导致数据丢失。

场景1：采集时标题被自动截断/后缀乱码修复

该场景占所有标题错乱问题的70%以上，通常由数据库字段长度不足、采集规则强制截取、字符集不匹配三个原因导致，按以下步骤依次排查：

步骤1：调整数据库标题字段长度

苹果CMS默认视频标题字段长度仅为100字符，长标题会被自动截断，登录数据库管理工具执行以下SQL语句修改长度：

``` ALTER TABLE `mac_vod` MODIFY COLUMN `vod_name` varchar(255) NOT NULL DEFAULT '' COMMENT '视频标题'; ```

注意事项：如果你的数据库表前缀不是mac_，请将SQL语句里的mac_替换为你实际的表前缀；如果是文章模块标题错乱，将表名改为mac_art，字段名改为art_name即可。

步骤2：修改采集节点的标题提取规则

• 登录苹果CMS后台，点击左侧【采集】-【采集节点管理】，找到对应标题错乱的采集节点，点击【编辑】
• 拉到【标题规则】配置项，删除规则里自带的substr、cut等截取函数，确保标题提取规则仅保留标签匹配，比如将{list}{title:cut=30}{/list}改为{list}{title}{/list}
• 拉到页面底部【字符集设置】，确认采集字符集和目标站字符集完全一致，目标站为UTF-8就选UTF-8，GBK就选GBK，不要选择自动识别

步骤3：修改全局内容过滤规则

进入后台【系统】-【网站参数配置】-【过滤设置】，删除标题过滤规则里的多余替换项，尤其是针对特殊符号的误判规则，比如误将“|”“·”等符号替换为空导致标题断档的规则，直接删除即可。

场景2：采集后标题出现大量重复前缀/后缀修复

该场景通常是目标站标题自带统一标识（比如“XX影院”“免费观看”等），可通过采集规则替换+存量数据批量修复解决：

步骤1：采集节点批量替换配置

进入对应采集节点的编辑页面，拉到【内容替换】配置块，添加替换规则：左侧填写要去掉的前缀/后缀内容，右侧留空，比如要去掉“[蓝光影院]”前缀，就左边填“[蓝光影院]”，右边填“”，支持多条替换规则，一行一条。

步骤2：已采集存量内容批量修复

已经采集入库的内容无需重新采集，执行对应SQL语句即可批量替换，以下为示例：

批量删除标题前缀：

``` UPDATE mac_vod SET vod_name = REPLACE(vod_name, '[蓝光影院]', '') WHERE vod_name LIKE '[蓝光影院]%'; ```

批量删除标题后缀：

``` UPDATE mac_vod SET vod_name = REPLACE(vod_name, ' - 免费观看', '') WHERE vod_name LIKE '% - 免费观看'; ```

将语句里的对应替换内容改为你实际要删除的前缀/后缀即可执行。

场景3：采集标题出现特殊符号乱码/问号修复

该场景为全站字符集不统一导致，尤其是emoji、日文、韩文等特殊字符无法正常显示，按以下步骤修复：

步骤1：确认全站字符集统一为UTF-8

首先执行SQL语句修改数据表字符集为支持全字符的utf8mb4：

``` ALTER TABLE `mac_vod` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```

然后打开程序数据库配置文件/application/database.php，确认charset配置为utf8mb4，以下为完整可复制的配置段：

``` // 数据库编码默认采用utf8 'charset' => 'utf8mb4', // 数据库表前缀 'prefix' => 'mac_', ```

修改源码文件请使用VSCode、Notepad++等专业代码编辑器，禁止用Windows自带记事本编辑，避免产生BOM头导致错乱。

步骤2：修改采集扩展配置

进入后台【采集】-【采集参数配置】，找到【自动转码】选项，开启自动转码，且设置默认转码为UTF-8，关闭“自动去除特殊字符”选项，避免误删标题里的合法特殊符号。

场景4：自定义采集接口返回标题错乱修复

如果你使用第三方API接口采集，出现标题错乱可按以下步骤排查：

步骤1：修改接口解析文件编码

找到你使用的自定义接口文件，通常存放在/application/extra/或者/application/api/controller/目录下，用代码编辑器打开文件，确认文件编码是UTF-8无BOM格式，不要用GBK编码保存。

步骤2：调整JSON解析规则

打开接口解析代码，删除对title字段的多余截取逻辑，以下为正误示例：

``` // 错误写法（强制截取30字符导致标题截断） $vod['vod_name'] = substr($api_data['title'],0,30); // 正确写法（仅去除首尾空格保留完整标题） $vod['vod_name'] = trim($api_data['title']); ```

修复后验证操作

• 保存所有修改的配置和文件，进入后台【系统】-【清理缓存】，清理全部站点缓存
• 新建一个采集测试任务，采集3-5条内容，查看标题是否正常显示
• 如果仍存在问题，进入后台【采集】-【采集参数配置】开启调试日志，采集后查看日志里的原始标题内容，确认是目标站标题本身问题还是本地规则问题