PHPCMS列表页数据不显示？3类高频问题排查修复实操全指南

害，前俩月我手里那台跑了6年的PHPCMS老站突然抽风，PHPCMS列表页数据不显示，我当时差点给服务器磕一个，蹲在电脑前啃着泡面熬了3小时，把能踩的坑全踩了一遍，今天全给你们唠明白，省得你们跟我似的，大半夜找外包还被人坑几百块调试费。

先唠明白：PHPCMS列表页数据不显示为啥像饭馆菜单掉链子？

咱打个通俗的比方啊，你的PHPCMS站点就是开在街面上的家常菜馆，后台是后厨，栏目分类是菜品种类，列表页就是门口贴的那张大菜单，客人路过先看菜单才知道你家卖啥。PHPCMS列表页数据不显示，说白了就是你家菜单墙突然空了，要么是后厨没把菜报过来，要么是传菜的伙计偷懒没贴，要么是刮风把菜单给掀了，就这三类事儿，没别的花活，根本不用慌。

我当年第一次碰PHPCMS列表页数据不显示的时候，以为是站点崩了要重装，差点把半年的内容都搞丢，现在回头看纯纯是自己吓自己，真的，按我给的步骤来，10分钟就能搞定，省下来的钱买杯冰奶茶喝它香不香？咱普通人过日子，能省则省，能自己动手就别当冤大头，对吧？

第一类坑：后厨没出菜（数据源本身出问题）

很多新手刚改完栏目配置就碰PHPCMS列表页数据不显示，90%都是这个坑，相当于你本来要把川菜放川菜窗口，结果手欠塞粤菜窗口了，粤菜窗口的菜单当然显示不了川菜的名字啊。

1. 栏目绑定模型不匹配

PHPCMS每个栏目都要绑定对应的内容模型，比如文章模型、下载模型、图片模型，你之前发的内容用的是文章模型，回头改栏目把模型改成下载模型了，系统找不到对应分类的内容，可不就给你空着嘛。过来人给你整理了排查步骤，照着点就行：

• 登录PHPCMS后台，进入【内容】-【栏目管理】，点击对应栏目右侧的【修改】按钮
• 查看【模型选择】栏的模型，跟你之前发布内容用的模型做对比
• 如果不一致改回原模型，更新全站缓存之后刷新页面试试

2. 内容未审核或者已删除

还有更离谱的，我上次帮个新手朋友排查PHPCMS列表页数据不显示的问题，折腾了半小时才发现，他发的内容全存在草稿箱里没点审核，相当于菜做好了放在后厨没给传菜员，前台当然看不到啊。还有的人不小心把对应栏目的内容全删了，那可不就啥都没有嘛，先去内容管理里搜搜对应栏目有没有已发布的内容，别啥都怪程序。

你看，这点小事儿犯不着找技术，自己动动手就搞定了，真的，只要思想不滑坡，办法总比困难多，咱普通人也能当半个技术大神。

第二类坑：传菜的伙计摸鱼（模板调用逻辑错了）

80%的PHPCMS列表页数据不显示问题，都出在模板上，相当于你家传菜的伙计拿错了菜单，或者漏写了菜名，客人当然看不到。我上次踩的就是这个坑，改模板的时候手滑把catid写错了，本来要调用12号栏目的内容，写成21号了，21号栏目我还没发内容，可不就PHPCMS列表页数据不显示嘛。

1. 列表调用标签写错

重点检查这几个参数，只要有一个错了，大概率就调不出来内容：

• catid参数：是不是当前栏目的ID，别写串了，要是想动态调用当前栏目就写catid="$catid"
• num参数：是不是大于0，你写num="0"的话，系统当然不会给你调内容
• where条件：是不是加了多余的过滤条件，把所有内容都筛掉了

给你们放个标准的列表调用标签，对照着改就行：

``` {pc:content action="lists" catid="$catid" num="20" order="id DESC" page="$page"} {loop $data $r}

{$r[title]}{$r[inputtime]}

{/loop} {/pc} ```

2. 分页参数缺失

还有的人是第一页有内容，翻到第二页就PHPCMS列表页数据不显示，那基本都是分页参数没带对，你标签里没加page="$page"的话，系统当然不知道你要翻第几页，可不就给你空着嘛。还有的人改了URL规则，把分页的路径改坏了，那也会出问题，碰到分页出问题的，先去看URL规则是不是跟模板里的分页调用匹配，别上来就拆服务器。

第三类坑：风把菜单刮跑了（缓存/权限问题）

这是最冤的一类坑，啥都没写错，就是缓存没更新或者权限设错了，相当于你新菜单印好了，还挂在库房里没往外贴，客人当然看不到。

1. 缓存没更新

我跟你们说啊，碰到任何PHPCMS列表页数据不显示的问题，第一步先去后台点全站缓存更新，更新完再刷新页面，80%的小问题直接就解决了。PHPCMS这个老伙计啥都好，就是缓存轴得很，你不手动点更新，它能把半年前的页面给你吐出来，我见过太多新手改完模板不更缓存，刷新一百遍喊网站坏了，纯纯自己折腾自己。

2. 栏目访问权限设错

还有的人给栏目设了会员权限，必须登录才能看，你没登录的话去访问当然PHPCMS列表页数据不显示，这个坑我也踩过，上次给客户做会员专区，手滑把公开栏目也加了权限，客户跟我说网站坏了，我登后台一看差点给自己一耳光。所以排查的时候也去栏目设置里看看【访问权限】是不是设了“全部游客可见”，要是设了特定会员组权限的话，改回来就行。

最后给你们掏个压箱底的万能排查公式

以后再碰PHPCMS列表页数据不显示，你就按这个顺序来，10分钟之内绝对能搞定：先更全站缓存→再查栏目模型和权限→再查模板调用标签→最后查数据库是不是丢内容了。按这个顺序走，别上来就去翻数据库，那纯属没事找事。

哦对，要是你按我这个方法还是没搞定，你也别慌，好好想想最近改了啥东西，PHPCMS这东西不会无缘无故坏，八成是你最近改的配置或者代码出问题了，改回去就行。真的，做网站跟过日子是一样的，哪有一帆风顺的，碰到点小问题很正常，我这过来人手把手给你把坑都踩平了，你照着走就行，省下来的时间多陪对象逛逛街，多吃两顿好的，它不比啥都强？

最后再提醒一句，别信网上那些说PHPCMS列表页数据不显示就是系统坏了要重装的，纯纯骗小白钱的，按我这个方法来，99%的问题都能自己搞定，咱普通人过日子，就讲究个实在，能不花的钱咱一分都不花，对吧？