EyouCMS留言页面常见异常排查修复纯实操操作指南

EyouCMS留言页面异常排查与修复实操指南

本文针对EyouCMS留言页面的常见异常（提交失败、列表不显示、页面空白等），提供零门槛、可直接落地的实操步骤，无需专业技术背景即可解决。

一、页面基础配置异常排查

• 步骤1：检查留言功能是否开启

  登录EyouCMS后台，地址为/eyoucms/admin.php（若修改了后台路径则对应调整），输入账号密码进入后，点击左侧【栏目管理】→找到已创建的留言栏目（如“在线留言”）→点击【编辑】→勾选【允许留言】【前台显示留言列表】→点击【保存】。

• 步骤2：检查模板文件是否存在

  通过FTP工具（如FileZilla）登录服务器，进入/eyoucms/template/你的模板名称/guestbook/目录（默认模板为default），确认是否有index.htm文件。若缺失，从官方EyouCMS安装包的对应模板目录复制该文件到当前路径。

二、留言提交异常（提交无响应/报错）修复

• 步骤1：检查表单提交路径正确性

  打开谷歌浏览器，按F12打开开发者工具，切换到【Network】标签，尝试点击页面的留言提交按钮，查看请求的Action路径。EyouCMS留言默认提交路径为/eyoucms/index.php?m=api&c=Guestbook&a=add。

  若路径错误，修改前台模板的表单Action：找到/eyoucms/template/你的模板名称/guestbook/index.htm，定位到

  标签，将Action属性改为上述正确路径，保存后上传覆盖原文件。

• 步骤2：验证表单令牌（Token）是否存在

  EyouCMS开启了CSRF防护，留言表单必须携带Token才能提交成功。在index.htm的表单内部，确保存在以下代码：

  ``````

  若缺失，直接添加到标签内部任意位置，保存上传。若修改后仍报错，可临时关闭Token验证（仅本地测试使用，生产环境禁止）：编辑/eyoucms/app/config.php，找到'csrf_check' => true,，修改为'csrf_check' => false,，保存上传。

• 步骤3：检查目录权限是否充足

  

  留言提交会生成临时缓存文件，需确保runtime目录有写入权限。通过FTP登录服务器，找到/eyoucms/app/runtime目录，右键设置权限为755（Linux主机）；Windows主机则确保该目录的IIS用户组有“写入”权限。

三、留言列表显示异常修复

• 步骤1：确认列表标签代码正确

  找到guestbook/index.htm中的留言列表区域，替换错误代码为EyouCMS官方标准标签：

  ```{eyou:guestbook list='1' type='default' row='10'}

  用户名：{$field.username}

  留言内容：{$field.content}

  {/eyou:guestbook}```

  注意：row='10'表示每页显示10条留言，可根据需求修改；不可删除{eyou:guestbook}与{/eyou:guestbook}的嵌套标签。

• 步骤2：检查数据库是否有留言数据

  进入phpMyAdmin（服务器提供的数据库管理工具），选择EyouCMS对应的数据库，找到ey_guestbook表，执行以下SQL命令查看是否有留言：

  ```SELECT FROM ey_guestbook;```

  若返回空数据，说明暂无用户提交留言；若有数据但仍不显示，返回后台【栏目管理】→编辑留言栏目→确认【前台显示留言列表】已勾选。

四、特殊异常快速排查

• 页面完全空白：检查模板目录路径是否正确，或后台【系统设置】→【模板设置】→确认当前使用的模板名称与实际目录一致；
• 提交后跳404：检查表单Action是否缺失/eyoucms/前缀，或是否将m=api误写为m=home；
• 后台看不到留言：检查栏目是否绑定了留言功能，或留言是否处于“待审核”状态（后台【留言管理】→勾选【显示待审核】）。