dede 列表分页不起作用

关键点：

• pagesize='20'：设置每页显示的文章数量,这个参数直接影响分页的总页数。
• [field:arcurl/]：文章链接,必须正确。
• {dede:list} 和 {/dede:list} 必须成对出现。

分页标签（核心）

在 {dede:list} 循环之后,必须放置分页标签。

推荐使用（强烈建议）：

<div class="dede_pages">
    <ul class="pagelist">
        {dede:pagelist listsize='4' listitem='info,index,end,pre,next,pageno'}
        </ul>
</div>

参数说明：

• listsize='4'：当前页前后显示的页码数量。
• listitem='...'：定义要显示的分页元素。info显示总信息，index显示首页，end显示尾页，pre/next显示上下页，pageno显示页码。

传统/旧版标签（不推荐，但可能存在于旧模板中）：

{dede:pagelist listitem="info,index,end,pre,next,pageno" listsize="5"/}

如果分页代码缺失或错误，分页链接就不会生成，请确保你的模板中包含了以上任一分页标签。

第二步：检查后台生成与数据

即使模板代码正确，如果数据没有生成,分页也无从谈起。

确认列表页已生成

• 进入后台 -> 生成 -> 更新栏目HTML。
• 在弹出的页面中,选择你需要更新分页的栏目。
• 关键操作：勾选 “选择高级选项”。
• 在高级选项中，找到 “选择列表页生成方式”，务必选择 “生成所有列表页” 或 “动态页”。
• 点击 “开始生成”。

为什么不选“仅动态页”？

• 选择“仅动态页”后，系统不会生成静态的HTML文件（如 list_1.html），当你在前台访问时，服务器会通过 arc.listview.class.php 脚本实时从数据库读取数据并生成页面，如果这个脚本或相关配置有问题,动态分页就会失效。
• 选择“生成所有列表页”可以确保静态文件被正确创建,这是最稳妥的测试方法。

检查栏目文章数量

• 进入后台 -> -> 普通文章 -> 文档列表。
• 筛选你那个有问题的栏目，看看文章总数是否大于 pagesize 的设置值（是否大于20）。
• 如果文章总数不足一页（比如只有2篇文章）,那么分页按钮自然不会显示。

检查栏目设置

• 进入后台 -> 核心 -> 频道模型 -> 栏目管理。
• 编辑出问题的那个栏目。
• 在栏目设置中，找到 “列表选项”。
• “列表命名规则”：确认这里填写的是正确的规则，list_{tid}_{page}.html,这决定了列表页的URL格式。
• “列表模板”：确认这里选择的是你刚才修改的、包含正确分页标签的模板文件（如 list_article.htm）。
• “文章命名规则”：确保文章的命名规则没有问题，因为 [field:arcurl/] 依赖于它。

第三步：检查URL与系统配置

分页链接是否能被正确解析,也依赖于URL规则。

检查分页链接格式

在后台生成列表页后,去你的网站根目录找到生成的文件。

• 第一页：list_1.html
• 第二页：list_2.html
• 第三页：list_3.html

如果你的列表命名规则是 list_{tid}_{page}.html，那么文件名就应该是这样，如果命名规则不同,文件名也会不同。

动态分页的URL格式通常是： /plus/list.php?tid=1&Page=2

检查URL rewrite（伪静态）

如果网站开启了伪静态,分页规则也需要正确配置。

• 进入后台 -> 系统 -> 系统基本参数 -> 核心设置。
• 找到 “是否使用伪静态”，选择 “是”。
• 然后进入 “模块设置” -> “系统设置” -> “伪静态规则”。
• 你会看到各种规则的示例，请确保你的服务器环境（Apache, IIS, Nginx）对应的规则中包含了列表分页的规则。

Nginx 伪静态规则中需要包含类似这样的行：

rewrite "^/list-([0-9]+)-([0-9]+)\.html$" /plus/list.php?tid=$1&Page=$2 last;
rewrite "^/list-([0-9]+)-([0-9]+)-([0-9]+)\.html$" /plus/list.php?tid=$1&Page=$2&totalresult=$3 last;

如果规则缺失或错误，服务器就无法将 list_1_2.html 这样的URL正确地映射到 plus/list.php 脚本上。

检查PHP文件是否存在

动态分页依赖于 /plus/list.php 这个文件，请确保你的网站目录中存在这个文件,并且没有被误删或权限错误。

第四步：检查数据库与PHP环境

如果以上所有步骤都正确无误,问题可能出在更深层次。

检查数据库记录

• 使用数据库管理工具（如 phpMyAdmin）登录你的网站数据库。
• 找到 dede_arctype 表（栏目表），检查你出问题的栏目的 typedir 字段是否正确。
• 找到 dede_archives 表（文章表），检查是否有属于该栏目的文章，typeid 字段正确。
• 找到 dede_arcmulti 表，这个表是专门用于处理列表分页的“虚拟文档”，如果生成列表页时出错，这个表里的记录可能会不完整或缺失，可以尝试清空这个表,然后重新生成所有列表页。

检查PHP错误日志

• 当访问分页页时，页面是否是空白,还是显示了错误信息？
• 检查你网站根目录下的 php_error.log 文件（或服务器配置的错误日志路径），里面可能会有具体的错误提示，比如变量未定义、函数调用失败等,这能帮你快速定位代码级的问题。

检查PHP版本兼容性

• 你使用的DedeCMS版本和你服务器的PHP版本是否兼容？非常老的DedeCMS版本（如5.3、5.5）在新版本的PHP（如7.4, 8.0, 8.1）上可能会因为函数废弃等问题而出错,尝试更换一个稳定兼容的PHP版本。

总结与排查清单

当你遇到列表分页问题时,请按以下顺序逐一检查：

1. 【模板】：检查 list_*.htm 文件中，{dede:list} 循环后是否有 {dede:pagelist}
2. 【生成】：进入后台，使用“更新栏目HTML”并选择“生成所有列表页”重新生成。
3. 【数据】：确认栏目下文章数量 > 每页显示数量。
4. 【栏目】：检查栏目设置中的“列表命名规则”和“列表模板”是否正确。
5. 【URL】：检查伪静态规则是否包含了列表分页的规则。
6. 【文件】：确认 /plus/list.php 文件存在。
7. 【数据库】：检查文章和栏目的关联是否正确，可以尝试清空 dede_arcmulti 表后重新生成。
8. 【环境】：查看PHP错误日志,检查PHP版本兼容性。