实测有效：PHPCMS留言功能各类异常问题一站式修复攻略

谁懂啊家人们，上个月我接了个老站维护的活，客户说他的PHPCMS站留言功能坏了快半年，用户提的合作需求全收不到，错过好几个几十万的订单，急的都快上火住院了。我本来以为phpcms留言功能异常修复嘛，多大点事，结果一上手才知道，那坑多的跟地雷阵似的，踩的我脚都麻了，折腾了整整两天两夜才给修好，今天把全套流程给你们捋明白，全是我拿头发换的干货，照着来绝对能修好。

先给大家整个魔性比喻方便理解：你就把网站的留言功能当成小区门口的快递驿站，用户提交留言是来寄件，后台收到留言是驿站入库，前台显示留言是驿站把件摆出来给大家看，所有的异常本质上都是这个驿站某个环节罢工了，咱们修的过程就是给驿站看病，对症下药就行。

先搞懂你家的留言驿站到底得了啥病

做phpcms留言功能异常修复最忌讳上来就瞎改代码，跟没看医生就乱吃药似的，搞不好本来只是小感冒，给你治成重症监护，咱先分清楚症状再下手。

第一种病：快递递不进去（用户提交直接报错/跳404）

这种是最常见的，用户填完所有信息点提交，要么直接弹“提交失败”，要么直接跳404页，相当于人家抱着快递来驿站，门都没进去就被保安撵走了。80%的情况都是你改模板的时候手欠删了关键字段，剩下20%是权限或者规则的锅。

第一步先查提交表单的核心字段，打开你的留言模板文件，一般路径是/phpcms/templates/你当前用的模板名/guestbook/index.html，先看表单的action属性是不是写对了，默认应该是index.php?m=guestbook&c=index&a=register，要是你改了伪静态或者模块路径记错了，肯定提交不成功。

然后重点找有没有csrf校验的隐藏字段，PHPCMSV9版本之后所有提交表单都要带这个字段做安全校验，很多前端改模板的时候觉得没用就给删了，相当于你去驿站寄件没带身份证，保安肯定不给你进。如果没有的话直接在form标签内部加下面这段代码就行：

``` ```

我当时做phpcms留言功能异常修复的时候就在这卡了俩小时，翻了N遍日志才发现是前段同事改模板的时候把这个字段删了，真的气的我差点把键盘吃了。

要是这俩都没问题，就去查服务器的文件权限，/caches目录权限是不是755，要是权限不够写不了缓存，提交请求也会被拦截，相当于驿站门锁锈了，你有钥匙也打不开门。

第二种病：快递收了但是锁仓库里了（用户显示提交成功后台啥都没有）

这种更气人，用户那边都弹“提交成功”了，你后台刷新八百遍啥都看不见，相当于驿站工作人员把件收了，随手扔在废弃仓库忘了登记，你查库存肯定查不到。

第一步先排除审核开关的坑，去后台找“模块-留言板模块-模块配置”，看看是不是开了“需审核后显示”，如果开了的话用户提交的留言默认是待审核状态，要去“留言板-待审核留言”里找，很多人不知道这个设置，以为是功能坏了，其实是后台给你藏起来了，我建议测试阶段先把审核关了，测通了再开。

要是关了审核还是没有，就去查数据库的留言表，默认表名是v9_guestbook，你看看表结构是不是缺字段，很多人升级PHPCMS版本的时候只升级了核心表，忘了升级留言表，导致数据写入的时候缺字段写不进去。你可以找个全新安装的同版本PHPCMS，对比下v9_guestbook的表结构，缺啥字段补上就行。

还有个特别隐蔽的坑，就是伪静态规则写错了，把留言提交的参数给吃了。我当时给另一个客户做phpcms留言功能异常修复的时候就遇到过，他自己改了.htaccess的伪静态规则，把guestbook的提交参数全给重定向没了，相当于快递运输路上被中转站给弄丢了，你肯定收不到。如果开了伪静态的话，记得给留言提交地址加个排除规则，Apache的话直接在.htaccess里加下面这段就行：

``` RewriteRule ^guestbook/index.php(.)$ /index.php?$1 [L] ```

第三种病：快递扔在驿站门口没人看得见（后台有留言前台不显示）

这种情况就是后台能看到留言，但是前台用户啥都看不见，相当于驿站把件入库了，但是全堆在仓库里没摆到取件区，用户肯定找不到。

第一步先查前台的调用标签，很多人改前台模板的时候，给留言调用的get标签加了多余的筛选条件，比如加了status=9或者type=1这种，后台的留言默认status是1（已审核）或者0（待审核），你写个不存在的状态值，肯定调不到数据。给你们个标准的调用模板，照着改就行：

``` {pc:content action="lists" catid="你的留言栏目ID" num="10" order="inputtime DESC" status="1"} {loop $data $v}

用户：{$v['name']} 留言时间：{date('Y-m-d',$v['inputtime'])}
内容：{$v['content']}

{/loop} {/pc} ```

如果标签没问题，那大概率是缓存的锅，PHPCMS默认开了静态缓存，你要是没设置留言页面动态更新，前台展示的还是几天前的缓存页，当然看不见新留言。你可以去后台“设置-缓存设置”里，把留言页面设置成不缓存，或者设置提交留言后自动更新对应页面的缓存，就能解决问题。

phpcms留言功能异常修复完的兜底操作，保你三年都不犯病

咱修东西不能光头疼医头脚疼医脚啊，就跟你感冒好了不得多喝热水多运动增强免疫力嘛对吧？修完之后给你三个土味小妙招，绝对能少踩80%的坑：

• 第一：改模板前先备份，别没事瞎改模板文件，改之前先存个备份，不然改坏了你都不知道哪里错了，下次再做phpcms留言功能异常修复的功夫都够你喝三顿奶茶了，没必要遭这个罪。
• 第二：别乱装不知名的第三方插件，很多小作坊做的插件都会改系统核心文件，装完之后要么把留言功能干崩，要么给你留后门挂木马，就跟你随便给手机装杂七杂八的APP似的，用不了两天就卡成狗，得不偿失。
• 第三：加个简易人机校验，自带的验证码现在基本拦不住垃圾留言，过不了半个月你后台就全是赌博、刷单的小广告，跟驿站被人塞了满墙牛皮癣似的，清都清不过来。我一般会加个简单的算术题校验，比如“3+5等于几”，基本能拦90%的垃圾留言，好用的很。

说实话现在用PHPCMS的基本都是运营了好多年的老站，就跟家里用了十来年的老冰箱似的，虽然老但是制冷没问题，没必要动不动就换系统，费钱费时间。遇到问题慢慢排查，实在搞不定的也可以找我，我这边攒了全套的phpcms留言功能异常修复的工具包，都是我踩坑踩出来的宝贝，免费给你都行。

咱做技术的嘛，就是互帮互助，你今天修好了站，明天说不定就能接个大单子赚的盆满钵满，加油打工人，好日子还在后头呢！