jQuery DataTable serverSide模式下分页页码不显示问题排查

其余功能正常仅分页页码缺失，优先按以下优先级定位疏漏：

前端初始化配置问题 #

• 确认分页开关未关闭：初始化参数必须保留paging: true，旧版写法对应bPaginate: true，如果误设为false会直接隐藏整个分页模块。
• 检查自定义dom配置是否遗漏分页占位符：如果手动配置了dom参数，字符串里必须包含p占位符才会渲染分页栏，比如标准配置dom: 'lfrtip'如果漏写末尾的p，分页控件不会生成。
• 确认单页长度配置合理：如果设置的pageLength值大于等于数据总条数，DataTable会默认自动隐藏分页控件，比如总数据共12条，pageLength设为20时就不会显示页码。
• 分页类型参数不要用非法值：pagingType需使用官方支持的枚举值（simple_numbers/full_numbers/simple/full/first_last_numbers），传入自定义的不存在的值会导致分页渲染失败。如果开启了scrollY/scrollX滚动模式，建议显式指定pagingType避免旧版本兼容问题。

后端接口返回参数问题（占此类问题的90%以上） #

如果你用的是服务端分页模式（开启了serverSide: true），接口返回的JSON结构必须严格符合约定，两个总数字段出错是页码不显示的核心诱因：

• recordsTotal：必须是数据库中符合查询条件的全量数据总条数，不能加limit分页限制，不能直接等于当前页返回的数据数组长度。
• recordsFiltered：必须是经过前端筛选条件过滤后的全量数据总条数，无筛选场景下该值与recordsTotal相等，同样不能赋值为当前页数据长度。

典型错误示例：全量数据共125条，分页每页返回10条，接口错误将recordsTotal和recordsFiltered都设为10，DataTable会判定总数据仅10条刚好铺满第一页，自动隐藏分页控件。

• 字段名必须严格匹配：不要写错字段名（比如少写s写成recordTotal、混用旧版字段名iTotalRecords却没做适配），大小写敏感场景下字段名不一致会导致DataTable读取不到总数值。
• 响应中的draw字段值必须和前端请求携带的draw参数值完全一致，返回固定值、小于请求值都会导致DataTable判定响应无效，部分版本下会出现分页渲染异常。

其他易忽略的场景 #

• 检查CSS资源加载与样式覆盖：打开浏览器开发者工具，在元素面板搜索paginate_button类名，确认分页元素是否已经生成只是被样式隐藏（比如自定义CSS设置了display: none、DataTable核心CSS文件未加载）。
• 检查draw回调逻辑：如果自定义了drawCallback函数，确认函数内没有手动删除分页DOM、调用分页相关API打断渲染流程的逻辑。
• 检查是否加载了冲突的插件：如果同一页面同时加载了其他表格插件、旧版本jQuery，可能出现$对象冲突导致分页渲染失败，可在控制台执行jQuery.fn.dataTable确认组件是否正常加载。

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