DedeCMS推荐功能不显示、点击失效故障 零基础分步实操修复指南

常见故障原因梳理

DedeCMS推荐功能故障90%以上都来自三类问题，我们按照从易到难的顺序排查修复，不需要专业开发知识，零门槛操作。

• 模板调用标签参数错误（新手最常见）
• 系统缓存、文档权限配置错误
• 推荐标记数据表异常

第一步：排查修复模板调用错误

首先打开你要显示推荐功能的模板文件，默认路径为 网站根目录/templets/你的当前模板目录/，比如首页推荐就是index.htm，列表页推荐就是list_article.htm之类的文件。

正确的推荐调用标签（可直接复制使用）

全网站通用的推荐列表调用标签如下：

```dede {dede:arclist flag='c' row='10' titlelen='60'}

[field:title/]

{/dede:arclist} ```

修改参数说明：row='10' 代表显示10条推荐，你可以改成自己需要的数量；titlelen='60' 代表标题最长显示60个字符，可按需调整。

如果你要调用指定栏目下的推荐内容，直接用以下完整可复制的代码：

```dede {dede:arclist flag='c' typeid='1' row='10' titlelen='60'}

[field:title/]

{/dede:arclist} ```

只需要把代码中 typeid='1' 的数字1改成你自己的栏目ID即可，栏目ID可以在DedeCMS后台「栏目管理」列表中直接看到。

这里有两个90%新手都会踩的坑，一定要核对：

• flag参数必须是小写c：推荐内容的官方标记就是小写字母c，写成大写C、其他字符都会导致无法识别，不会输出内容
• 必须闭合arclist标签：结尾必须有完整的 {/dede:arclist}，漏写会导致页面报错、推荐内容完全不显示

第二步：清除缓存，检查文档配置

模板调用正确还是不显示？接下来清理系统缓存，步骤如下：

• 1. 登录DedeCMS网站后台，默认后台地址为 你的域名/dede/，输入管理员账号密码登录
• 2. 在左侧导航栏找到 生成 → 一键更新网站，点击进入
• 3. 勾选「更新所有主页、更新所有栏目页、更新所有文档页」三个选项，点击「开始更新」，等待更新完成
• 4. 回到左侧导航栏，点击 系统 → 系统缓存处理 → 清空所有缓存，完成后退出页面

接下来检查文档的推荐标记和状态是否正确：

• 1. 后台左侧点击 内容 → 内容文档管理，找到你标记为推荐的文档，点击「修改」进入编辑页
• 2. 在编辑页找到「属性设置」板块，确认「推荐」勾选框已经勾选
• 3. 确认文档的发布状态是「已发布」，浏览权限是「开放浏览」，不是未审核、会员专属状态
• 4. 保存修改后，重复一遍上述清空缓存、更新页面的操作

第三步：修复推荐标记数据表异常

如果前两步操作完成后故障依旧，大概率是推荐标记存储的数据表字段异常，直接用DedeCMS自带的SQL工具修复，操作如下：

• 1. 后台左侧点击 系统 → SQL命令行工具，进入命令执行页面

场景1：全站推荐都不显示，执行以下SQL

直接复制下方完整SQL，粘贴到命令输入框，点击「提交」即可：

```sql ALTER TABLE `dede_archives` MODIFY COLUMN `flag` VARCHAR(10) NOT NULL DEFAULT ''; UPDATE dede_archives SET flag = TRIM(flag); ```

这段代码会修复推荐标记字段的格式异常，清除多余的空格、特殊字符。

场景2：仅指定栏目推荐不显示，执行以下SQL

```sql ALTER TABLE `dede_arctype` MODIFY COLUMN `flag` VARCHAR(10) NOT NULL DEFAULT ''; UPDATE dede_arctype SET flag = TRIM(flag); ```

注意：如果你的网站数据库表前缀不是默认的 dede_，需要把代码中所有的 dede_ 改成你自己的表前缀，表前缀可以在网站根目录的 data/common.inc.php 文件中找到，打开搜索 $cfg_dbprefix 就能看到。

第四步：修复目录权限故障（Linux服务器/虚拟主机适用）

如果你的网站架在Linux服务器或者虚拟主机上，还有一种可能是缓存目录权限不足，无法生成推荐内容的静态缓存，修复方法：

• SSH登录服务器用户，进入网站根目录后执行以下命令：

```bash cd 你的网站绝对根目录 chmod -R 755 data/ templets/ uploads/ ```

• 虚拟主机用户，直接在虚拟主机控制面板的文件管理器中，选中 data、templets、uploads 三个文件夹，修改权限为755即可。

最终验证操作

所有步骤完成后，打开网站前台，强制刷新浏览器缓存（Windows按Ctrl+F5，Mac按Command+Shift+R），即可查看推荐功能是否恢复正常。

如果还是无法显示，按以下顺序再次核对：

• 1. 确认你标记为推荐的文档总数大于等于模板调用的row数量，比如你设置row=10，但只标记了3个推荐，会显示内容不全，但不会完全不显示
• 2. 确认你修改模板后已经保存并上传到服务器，不要只修改了本地文件没有覆盖服务器上的旧模板
• 3. 如果你的网站使用了CDN加速，请到CDN后台刷新全站静态缓存后再查看