海洋 CMS 采集后的播放地址失效怎么排查

采集后播放地址失效，绝大多数情况不是采集器坏了，而是三件事之一：入库时对应播放器没启用导致地址被直接丢弃、播放地址里的域名/前缀替换规则配错、或者解析播放器（把网页地址转成 m3u8/mp4 直链的接口）挂了。按「先查数据库 → 再查后台播放器设置 → 最后验证地址本身」的顺序走，10 分钟内能定位到具体环节。

播放地址到底有没有入库，怎么查？

结论：播放地址失效要先分成「库里根本没地址」和「库里有地址但播不出来」两类，这两类的原因和修法完全不同。

海洋 CMS 的播放地址存在数据库 sea_data 表的 vod_play_url 字段里，格式是 第1集$http://xx/a.m3u8#第2集$http://xx/b.m3u8——集数名和地址用 $ 分隔，多集之间用 # 分隔。

直接用 SQL 看一眼就知道属于哪一类：

SELECT vod_id, vod_name, LENGTH(vod_play_url) AS len FROM sea_data WHERE vod_id = 1234;

vod_play_url 为空或者只有几十个字符（说明只入库了剧集名没有地址），问题在采集入库环节，看下一节；字段里是完整的 $ 和 # 结构，说明地址已经进库，直接跳到第三节。

采集入库后地址为空，问题在哪？

结论：最常见的原因是采集时对应的播放器没启用，海洋 CMS 在入库阶段会直接丢弃未启用播放器的地址，表现就是剧集信息有了、播放列表是空的。

排查两处：

第一，进后台的播放器管理（不同版本叫「播放器」或「播放器设置」），确认采集源使用的那组播放器标识（比如 bfzy、lzm3u8 这类资源站代号）已经勾选启用。禁用状态下的播放器，采集脚本拿到的地址不会写进 vod_play_url。

第二，绕开 CMS 直接验证采集接口。把采集接口 URL 复制到浏览器里打开，看返回的 XML/JSON 里 <dd> 或播放地址节点有没有内容。接口本身就返回空，那是资源站那边断更或改了字段名，跟你的站点无关。

库里有地址却播不了，怎么区分是地址问题还是解析问题？

结论：把采集到的那条播放地址直接丢给播放器验证——直链能播就是解析播放器的问题，直链也不能播就是地址本身的问题。

具体做法：从数据库里复制一条完整地址，用 VLC 或 ffprobe 打开：

ffprobe -v error -i "http://cdn.example.com/hls/1234/index.m3u8" -show_entries format=duration
curl -I "http://cdn.example.com/hls/1234/index.m3u8"

按返回码判断：403 通常是源站开了防盗链（Referer 校验），换成本站域名做 Referer 再试；404 是资源站删档或改了路径，这条地址已经死了；能正常返回 200 但前端仍旧黑屏，多半是 HTTPS 页面加载 HTTP 地址的混合内容被浏览器拦截。

如果采集的是「网页地址」而不是 m3u8/mp4 直链，那还需要解析播放器把它转成真实地址。解析接口变了、播放器 JS 文件被覆盖或 404，症状同样是「播放地址失效」。这时候打开 F12 的 Network 面板，看播放器目录下的 js 文件是否返回 404，以及解析请求的响应内容。

批量地址失效怎么做替换修复？

结论：整批资源的域名变了，用数据库批量替换比重新采集快得多，但必须先备份。

mysqldump -u root -p 数据库名 sea_data > sea_data_backup.sql

UPDATE sea_data
SET vod_play_url = REPLACE(vod_play_url, 'http://旧域名', 'http://新域名')
WHERE vod_play_url LIKE '%http://旧域名%';

改完记得进后台更新一次缓存——前端播放列表大部分是读缓存的，不改缓存会以为替换没生效。如果站点有多个播放组（vod_play_from 字段里用 $$$ 分隔来源），替换时要注意别把某一组的地址串到另一组去。

排查完还是播不了，还要看什么？

结论：剩下两类容易被忽略的原因，一是浏览器缓存/CDN 缓存，二是播放器组和播放地址不匹配。

海洋 CMS 的播放地址和播放器组是按顺序对应的，vod_play_from 里的第一个来源对应 vod_play_url 里的第一组地址。手工改过数据库、或者采集后又手动删过一组播放器，就容易错位，表现是「有集数、点开报错」。核对这两个字段的分组数量是否一致即可。

最后，如果页面用了 CDN，改完数据库后要刷一次 CDN 缓存，否则外部访问还是旧地址。

总结一下排查顺序：先查 sea_data.vod_play_url 判断地址有没有入库；没入库就查后台播放器是否启用、采集接口是否返回地址；入库了就单条 URL 用 ffprobe/curl 验证，403 查防盗链、404 是源站删档、能播但前端口播错就是解析接口或 js 文件的问题；整批失效用 SQL 批量替换加更新缓存收尾。整个过程不需要重装或重采，按这个顺序基本能一次定位。