苹果CMS列表页不显示内容 多场景排查修复完整实操指南

第一步：检查基础缓存与权限配置

超过60%的列表页不显示问题都来自缓存和权限错误，先从这两步最简单的操作开始排查，不用先动代码。

1.1 清空系统缓存

• 打开你的网站后台地址（一般为你的域名/admin.php），输入账号密码完成登录
• 在左侧菜单栏找到系统 -> 系统缓存与备份选项点击进入
• 点击页面中的清空全部缓存按钮，等待系统提示清空完成后，返回前台列表页刷新查看是否恢复

1.2 检查目录读写权限

如果清空缓存后依然不显示，检查核心目录的读写权限，Linux服务器必须配置正确权限才能生成缓存和解析模板：

• 通过FTP软件或者主机面板的文件管理，进入你的网站根目录
• 找到根目录下的cache缓存目录和template模板目录
• 给这两个目录以及所有子目录、文件设置权限为755，如果755依然报错，可以临时设置为777测试，修复后务必改回755保证安全
• 设置完成后再次刷新列表页查看效果

第二步：检查模板调用代码错误

缓存和权限没问题后，最常见的原因就是模板的列表调用语法错误，苹果CMSv10对标签语法要求严格，写错一个字符就会导致不显示内容。

2.1 常见错误点排查

• 标签前缀错误：苹果CMSv10的列表调用必须加maccms前缀，正确主标签是{maccms:vod}（视频站）、{maccms:art}（文章站），漏写前缀写成{vod}会导致无法解析，不输出内容
• 分类参数错误：分类页列表需要绑定当前分类id，正确写法是id="{$obj.type_id}"，如果写死不存在的分类id，自然不会加载出内容
• 分页参数错误：必须添加paging="yes"开启分页，否则不会输出列表内容

2.2 可直接复制的正确调用代码

如果找不到错误，可以直接替换为以下对应类型的正确代码，保存后清空缓存即可：

视频站分类页列表调用代码：

``` {maccms:vod num="12" paging="yes" order="desc" by="time" id="{$obj.type_id}"}

{$vo.vod_name} {$vo.vod_remarks}

{/maccms:vod} {$obj.page} ```

文章站分类页列表调用代码：

``` {maccms:art num="12" paging="yes" order="desc" by="time" id="{$obj.type_id}"}

{$vo.art_name} {$vo.art_addtime|date='Y-m-d'}

{/maccms:art} {$obj.page} ```

第三步：检查分类绑定与数据归属

模板代码正确依然不显示，要检查内容本身是否正确归到当前分类：

• 登录后台点击视频/文章管理 -> 分类管理
• 找到出问题的列表对应的分类，点击编辑，检查分类状态是否设置为显示，如果设置为隐藏，前台不会输出任何内容
• 打开对应内容列表，随机点开一条内容编辑，检查该内容的所属分类是否选中了当前列表对应的分类，如果没有选中，内容不会出现在当前列表
• 如果是采集的内容，检查采集规则是否配置了分类绑定，很多未配置的采集规则会把所有内容归到未分类，前台公开分类列表自然没有内容

第四步：检查伪静态配置错误

开启伪静态后，规则配置错误会导致分类id参数无法正确传递，最终加载不到内容，不同环境给出可直接复制的正确规则：

4.1 宝塔面板Nginx环境配置（最常用）

• 打开宝塔面板 -> 对应站点设置 -> 伪静态
• 删除原有内容，粘贴以下规则后点击保存： ``` location / { if (!-e $request_filename){ rewrite ^(.)$ /index.php?s=$1 last; break; } } ```

4.2 Apache环境配置

打开网站根目录的.htaccess文件，替换为以下内容：

``` RewriteEngine On RewriteBase / RewriteRule ^index\.html$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] ```

第五步：检查数据库配置错误

以上排查都完成后依然不显示，检查数据库层面的问题：

• 打开网站根目录下的/application/database.php文件，检查数据库配置是否正确，迁移网站后很容易出现配置错误，正确配置示例如下，修改对应参数即可使用： ``` return [ 'type' => 'mysql', 'hostname' => '127.0.0.1', 'database' => '填写你的实际数据库名', 'username' => '填写你的实际数据库用户名', 'password' => '填写你的实际数据库密码', 'hostport' => '3306', ]; ``` 修改后保存，清空缓存再次测试
• 检查数据库是否有实际内容：通过phpMyadmin登录数据库，打开mac_vod（视频表）或者mac_art（文章表），查看表中是否有数据，如果采集失败表为空，自然不会显示内容

按照以上五步从易到难排查，99%的苹果CMS列表页不显示问题都可以解决，每一步操作完成后都可以直接测试，不用完成所有步骤，找到问题修复即可。