海洋 CMS 采集接口失效如何快速替换

海洋CMS采集接口失效，最快的恢复方式不是修旧接口，而是在后台新增一个可用接口、把分类绑定切过去，已入库的视频数据完全不用动，熟练的话 10 分钟内能恢复采集。下面按“判断—替换—批量处理—避坑”四步说清楚。

怎么判断是接口失效，还是别的问题？

结论：先在服务器上用 curl 直接测接口地址，返回超时、502、403 或 HTML 页面，才是接口本身的问题；如果 curl 正常但后台采集报错，那问题在 CMS 的采集类型或分类配置上。

在服务器 SSH 里执行（把 URL 换成你自己的接口地址）：

curl -s -m 10 -o /dev/null -w "%{http_code} %{time_total}\n" "http://接口域名/api.php/provide/vod/?ac=list"

判断标准很硬：返回码必须是 200，time_total 应在 3 秒以内，然后用 curl -s -m 10 "接口地址" | head -c 300 看内容，正常结果是以 { 开头的 JSON，或以 <?xml 开头的 XML。返回 <!DOCTYPE html 说明对方站点挂了或被换了域名，返回 403 通常是你的服务器 IP 被对方拉黑，返回超时是网络不通——这三种情况换接口地址即可解决，不用动 CMS。

海洋CMS里替换采集接口的具体步骤

结论：替换分两步——先新增接口并读通分类，再把原有分类绑定改到新接口上，顺序不能颠倒。

第一步，进后台采集管理里的采集接口（资源站）列表，点新增，填三项：接口名称（自己好认的名字）、接口地址（注意别丢掉结尾的 ?ac=list）、接口类型（海洋CMS格式还是苹果CMS JSON格式，必须和接口实际返回的格式一致，选错会出现“采集成功但 0 条数据”）。

第二步，保存后先读一次分类列表。读得出来，说明接口通、格式对；读不出来，回到上一步换格式重试。

第三步，在分类对接里，把每个目标分类的来源接口改成新接口、并选好对应的远程分类 ID。这一步是真正的“替换”，旧的采集任务和定时任务里如果写死了接口，也要一并改掉。

第四步，试采 1 页而不是全量采集，逐条看标题、播放地址、封面图三项。播放地址能点开、封面正常显示，再放开全量。

接口地址变了，能不能批量改而不用一个个点？

结论：能，直接改数据库里的接口地址字段，但改之前必须备份。

先备份一次：

mysqldump -u数据库用户 -p 数据库名 > /root/backup_$(date +%F).sql

然后找到存采集接口地址的那张表（海洋CMS 的表一般带 sea_ 前缀，字段名以你自己库里 DESC 表名 的结果为准），执行替换：

UPDATE 采集接口表 SET 接口地址字段='http://新域名/api.php/provide/vod/' WHERE 接口地址字段='http://旧域名/api.php/provide/vod/';

改完在后台清一次缓存、重新读取分类确认生效。这样做的价值在于：当你对接了 5 个以上分类时，比在后台逐个点能省十几分钟。

替换接口时最容易踩的四个坑

结论：采集能跑通不等于能播，替换后必须验证播放和图片两条链路。

第一，播放地址前缀不匹配。不同资源站的播放地址格式不同，采集回来是 $播放器$地址 的形式，如果本地播放器组没配对应播放器，前台就是黑屏。替换接口后要顺手核对一次播放器组。

第二，封面图防盗链。新接口的图片域名往往带 Referer 校验，本地不做图片本地化或反向代理的话，前台全是裂图。

第三，去重。换接口后新旧数据源会重叠，建议按 vod_name 或 vod_id 开去重，避免同一部剧出现两条记录。

第四，别删旧接口的已采数据。删了再采一遍，重复数据、播放记录和评论都会受影响，只改绑定关系就够。

整套流程的核心就一句话：失效的是接口地址，不是你的数据；新增接口、切分类绑定、验证播放与图片，是替换海洋CMS采集接口最短的路径。