EyouCMS文章摘要调用失败修复全流程，看完照着做就能好

你有没有遇过这种情况？用EyouCMS搭的企业站或者博客。好不容易写完一篇新文章。前端列表页的摘要要么是空的。要么满屏乱码带HTML标签。改了一下午代码也没找着问题？我之前帮客户改站的时候，半个月碰见过三次同款问题。其实根本不是啥大bug，99%都是操作漏了步骤。今天把完整排查步骤给你捋清楚，照着走10分钟就能修好。

第一步：先查调用代码，80%的问题都在这

1. 核对标签写法有没有错

EyouCMS默认的摘要调用字段是{$field.description}

很多新手容易跟其他CMS搞混，写成{$field.content}或者{$field.intro}

还有用自定义模型的朋友，记得先给模型加description字段

举个正确的列表页调用例子：

``` {eyou:arclist titlelen='30' len='120' typeid='all'}

{$field.title}

{$field.description}

{/eyou:arclist} ```

避坑提醒：不要随便给摘要标签加过滤函数

很多人怕有XSS风险，自己加了htmlspecialchars之类的函数。反而会把中文转成乱码，默认的标签已经带过滤了，不用额外加。

2. 核对截取参数有没有写错

EyouCMS的摘要长度控制，是在arclist标签里加len参数

不少人会写成leng、cut、length之类的，全都是无效的

如果len参数填0，就会直接输出完整摘要，不会自动截取

还有人把len参数写在li标签或者p标签里，也是不生效的，必须放在arclist的起始标签里。

第二步：查后台配置，很多人这里忘了开

1. 检查全局自动摘要开关

要是你发文章从来没手动填过摘要。就得先确认后台开了自动提取功能

路径给你放这：后台→系统→系统基本参数→核心设置

找到“是否自动提取文档摘要”，选“是”

下面的“文档摘要自动截取长度”，填100到200之间就行，别填0

改完记得点底部的确认按钮保存，不然不会生效。

2. 检查单篇文章的摘要内容

要是只有某几篇文章摘要调不出来，大概率是单篇的问题

打开对应文章的编辑页，拉到最下面的摘要输入框

看看是不是填了全空格、表情、或者带HTML标签的内容

直接手动输一段纯文本的摘要，保存了再刷新前端看

要是手动填的能出来，就是自动提取的时候碰着特殊内容卡住了。比如你文章开头放了大量代码、表格，自动提取的时候识别失败，手动填个摘要就行。

第三步：排查缓存和兼容性问题

1. 先清所有缓存再测试

很多人改完代码和配置，刷了十遍前端还是旧内容

先点后台右上角的清除缓存按钮，清完后台缓存

再清浏览器缓存，或者直接开无痕模式访问网站

别嫌麻烦，我见过好多人折腾俩小时，就是没清缓存，改的内容根本没更新到前端。

2. 排查插件和版本兼容问题

要是最近装了新插件之后才出的问题，直接挨个禁用插件

哪个插件禁用之后摘要恢复了，就是它的问题

要么找插件作者更新，要么直接卸载换同类功能的插件

要是刚升级完EyouCMS版本出的问题，就是升级包没覆盖全

去官网下对应版本的完整升级包，重新覆盖application文件夹就行

避坑提醒：覆盖文件前一定要先备份整个网站

万一覆盖错了版本，还能靠备份恢复，不会直接把站搞崩。

就这三步，按顺序查下来，基本所有摘要调用失败的问题都能解决

别上来就乱改核心文件，改坏了反而更麻烦

现在就打开你的网站后台，按照步骤挨个核对，10分钟就能搞定

要是还有特殊情况搞不定，评论区留个言，我看到了就回你