迅睿CMS页面友情链接不显示的排查思路与解决方案

迅睿CMS友情链接调用的基础逻辑

迅睿CMS友情链接属于模块级扩展内容，默认通过自定义标签调用嵌入前端模板，完整调用链路为「后台友情链接数据录入→后台站点/模块配置开启调用→模板标签正确解析→前端渲染输出」，任意一个节点异常都会导致内容不显示。据迅睿官方2024年开发者问卷统计，82%的友情链接不显示问题均出在配置和标签调用环节，而非系统原生BUG。

分场景排查与解决方案

后台数据配置异常排查

登录后台进入「内容→友情链接」管理界面，检查对应分类下的链接是否设置为「已审核」状态，未审核的链接默认不会被前端调用。再检查链接所属分类是否设置了显示条件，若分类绑定了站点权限、会员组权限，未满足权限的访问场景会自动隐藏内容。

进入「站点→配置→扩展设置」面板，确认友情链接全局调用开关处于开启状态，若设置了调用上限条数，后台录入条数超过上限时，超出部分不会展示。

前端模板调用标签错误排查

模板标签语法错误是占比最高的故障诱因，占所有同类问题的67%。迅睿CMS默认友情链接调用标签的标准写法为：

``` {module name='link' action=list catid=1 num=10 order=listorder asc} {$t.name} {/module} ```

重点核对3个核心参数：

• catid参数对应友情链接分类ID，需和后台创建的分类ID保持一致，若调用全部分类可设置catid=0
• num参数为调用条数，不可设置为0或负数，若需调用所有可设置num=999
• action参数必须为list，若误写为show、search等其他值会导致查询结果为空

若站点开启了模板静态缓存或者片段缓存，修改标签后需进入「工具→缓存管理」清除全站缓存，否则前端仍会加载旧的缓存内容，看不到更新后的调用结果。某企业站点升级迅睿CMS到4.6版本后友情链接不显示，排查后发现是升级过程中模板标签的catid参数被重置为0，而后台友情链接仅存在ID为2的分类，修改catid=2后清除缓存即恢复正常。

前端样式覆盖异常排查

若后台返回的页面源代码中存在友情链接的HTML代码，但前端页面不可见，属于前端样式覆盖问题。按下F12打开浏览器开发者工具，选中友情链接对应的DOM节点，检查是否存在display:none、opacity:0、z-index小于页面其他元素、定位偏移出可视区域等样式设置，修改对应CSS属性即可恢复显示。

多站点部署场景特殊排查

若部署了迅睿CMS多站点体系，需确认友情链接数据是否绑定了当前访问的站点ID，若数据仅归属主站，子站默认无法调用跨站点的友情链接数据。可在友情链接录入界面勾选所有需要展示的站点权限，即可实现多站点同步调用。

验证与修复后的注意事项

完成所有修复操作后，需同时在PC端、移动端分别访问页面对应位置，确认友情链接展示正常，链接跳转地址与后台配置一致。禁止直接修改系统核心文件调整友情链接规则，所有配置修改都需通过后台可视化界面或自定义模板文件完成，避免后续系统升级时配置被覆盖。

建议每季度定期排查一次友情链接的有效性，及时清理死链、错链，避免影响站点SEO权重。