列表接口分页，别只看页码和每页条数

管理后台和移动应用经常要展示订单、设备或日志列表。数据量变大后，分页可以控制单次返回的内容，但如果排序和参数规则没有定义清楚，用户翻页时仍可能看到重复记录或漏掉记录。设计分页接口时，除了页码和每页条数，还要考虑数据变化和排序稳定性。

一、让排序结果稳定

分页前应明确默认排序字段，并在排序值相同时增加唯一字段作为次级排序。例如仅按创建时间排序，多个记录时间相同就可能在不同请求中换位置；再按唯一编号排序，顺序会更确定。客户端也应把当前筛选和排序条件随分页请求保持一致。

二、理解页码分页的边界

页码加偏移量适合常见的后台列表，但请求之间如果有新记录插入或旧记录删除，后续页的位置可能发生变化。用户连续翻页时，可能重复看到一条，也可能跳过一条。对实时变化的数据，应根据业务容忍度决定是否接受这种现象，或使用稳定排序值作为游标继续读取。

三、控制单次查询规模

接口需要校验页码和每页数量，设置合理的上限，避免客户端传入过大的数量拖慢查询。总数统计也不一定每次都要精确返回；如果统计成本较高，可以由产品需求决定是否展示总条数，或采用延迟统计方式。空结果、超出末页和参数错误都应有一致的响应约定。

四、把分页行为纳入验证

除正常数据外，还要检查排序值相同、筛选条件变化、新数据写入以及翻到最后一页等情况。日志记录查询条件和分页位置，便于发现耗时请求与用户反馈。接口文档应注明排序、默认页大小、最大值和边界行为，避免不同客户端各自猜测。

分页不是单纯切片，而是接口对顺序、数据变化和查询成本的约定。把这些规则提前说清楚，调用方才能稳定地浏览列表。