vTiger 7.3.0线索分页下一页按钮失效及每页显示数异常问题

问题复现 #

• 配置每页显示20条线索时，各页显示条数不一致：第一页19条、第二页13条、第三页11条，其余页面11-14条
• 下一页按钮处于启用状态，但点击无响应，需手动输入页码切换
• 仅按线索创建日期降序排序时，分页功能正常
• 已对比正常运行实例的分页及线索数量相关代码，未发现差异

排查与修复步骤 #

1. 检查数据完整性与重复记录 #

线索表可能存在重复主键或异常数据，导致分页查询计数偏差：

• 执行SQL排查重复记录：

  -- 检查线索主表重复记录
  SELECT leadid, COUNT(*) FROM vtiger_leaddetails GROUP BY leadid HAVING COUNT(*) > 1;
  -- 检查CRM实体表中线索类型的重复记录
  SELECT crmid, COUNT(*) FROM vtiger_crmentity WHERE setype='Leads' GROUP BY crmid HAVING COUNT(*) > 1;
  

• 若存在重复数据，备份后清理异常记录。

2. 排查筛选与排序逻辑冲突 #

非默认排序字段或隐藏筛选条件可能干扰分页计算：

• 点击列表页「重置筛选」按钮，清除所有自定义筛选规则后测试分页
• 检查排序字段属性：若使用自定义字段排序，确认该字段无大量空值；可在排序SQL中显式处理空值优先级，例如：

  ORDER BY custom_field IS NULL, custom_field DESC
  

3. 修复JavaScript事件绑定异常 #

下一页按钮无响应大概率是JS事件未正确绑定：

• 打开浏览器开发者工具（F12），切换到「控制台」，点击下一页按钮查看是否有报错信息
• 重新替换layouts/vlayout/modules/Vtiger/resources/Pagination.js文件（从正常实例拷贝），清除vTiger缓存后测试

4. 清理缓存与修复数据库索引 #

缓存或索引异常可能导致分页查询结果偏差：

• 清除vTiger系统缓存：「设置」→「系统设置」→「性能」→「清除缓存」，同时清除浏览器缓存
• 检查并添加必要索引：

  ALTER TABLE vtiger_crmentity ADD INDEX idx_createdtime (createdtime);
  ALTER TABLE vtiger_leaddetails ADD INDEX idx_leadid (leadid);
  

5. 调试分页偏移量计算逻辑 #

非默认排序时，排序结果不稳定（如字段值大量重复）可能导致偏移量计算错误：

• 在浏览器开发者工具「网络」标签，查看分页请求的page、limit、orderby、sortorder参数，确认后端接收参数正确
• 调试modules/Vtiger/models/List.php中的getQueryResults方法，输出实际执行的SQL语句，对比不同排序条件下的LIMIT/OFFSET计算是否正确

内容的提问来源于stack exchange，提问作者Eduardo Calderon