海洋 CMS 播放页相关影片不显示是什么问题

海洋CMS播放页相关影片不显示，90% 的情况出在三处：播放页模板里相关影片标签被删掉或写错、后台缓存／静态页没重新生成、数据库里根本没有能匹配上的影片。

海洋CMS播放页相关影片不显示，第一步该查什么？

结论：先用「标签是否还在 + 缓存是否更新」这两步排除掉最容易踩的坑，能解决大部分不显示的问题。

第 1 步，查播放页模板。 进后台 → 模板 → 找到当前使用的模板目录 → 编辑播放页模板（文件名一般以 play 开头，如 play.html）。在编辑器里搜索 related 或「相关影片」关键字，确认三件事：标签还在不在、有没有被 <!-- --> 注释掉、成对标签有没有闭合。如果前台页面直接输出了一串带花括号的原始代码，说明标签没被解析——基本可以判定是标签写错或标签名与当前版本不匹配。

第 2 步，对照默认模板。 把模板切换回官方默认模板，清空缓存后刷新播放页。默认模板能正常显示 → 问题在你的模板文件；默认模板也不显示 → 问题在数据或环境，不要再去改模板。

第 3 步，更新缓存。 后台 → 系统 → 缓存管理，执行一次「更新缓存」（清理模板编译缓存和数据缓存）。海洋CMS 会把模板编译结果缓存起来，改完模板不更新缓存，前台看到的还是旧内容。

为什么后台明明有影片，相关影片还是不显示？

结论：相关影片不是随机抓取，而是按「同分类、同演员、同关键词」等规则去匹配，匹配不到就整块空白。

常见的四种「匹配不到」：

1. 数据量太少。 新站只有十几部片子，同分类下没有其他影片，自然无相关内容可调。分类下至少有 2 部以上影片才有机会出现。
2. 主演字段为空或不一致。 采集来的数据里主演字段经常是空值，或者同一个演员写成「张三,李四」和「张三 李四」，分隔符不统一就匹配不上。可以进后台影片列表抽查几条，看主演、分类字段是否完整。
3. 分类 ID 被改动或影片未归类。 影片挂在「未分类」下时，按分类关联的规则失效。
4. 标签参数限制太严。 比如限制了 num（显示条数）过小、指定了某个分类 ID 而该分类没有内容，都会导致输出为空。

相关影片标签怎么写才生效？

结论：标签必须写在播放页模板内、不能被 HTML 注释包裹、且成对闭合，改完后必须重新生成静态页或更新缓存。

操作顺序建议这样走：后台编辑播放页模板 → 确认标签成对闭合 → 保存 → 后台清除缓存 → 如果站点开启了 HTML 静态生成，还要进「生成」→ 重新生成播放页（或一键生成全站）。**海洋CMS 开启静态化后，播放页是实体 HTML 文件，改了模板和数据不重新生成，前台永远不会变**，这是最容易被忽略的一步。

如果站点套了 CDN 或浏览器有强缓存，用无痕窗口或无缓存刷新（Ctrl+F5）再验证一次，避免误判。

更新缓存、重新生成后还是不显示，还查什么？

结论：到这一步基本是环境或权限问题，重点看 PHP 错误日志和目录权限。

• 打开 PHP 错误显示，刷新播放页，看是否有 Undefined index、Call to undefined function 一类报错。模板标签解析依赖 PHP 环境，函数被禁用会直接导致标签失效。
• 检查 data、cache、模板编译目录是否可写（一般要求 755，部分环境需要 777），权限不足时缓存写不进去，标签解析结果无法落地。
• 如果做过二次开发或装过插件，回退到官方原版文件对比一下，第三方修改是最隐蔽的原因。

一句话收尾：先查模板标签是否完整，再清缓存、重新生成静态页，最后检查影片数据的分类和主演字段是否可匹配——按这个顺序走，基本能把「相关影片不显示」定位到具体某一环。