Android Paging 分页加载与状态管理

摘要：分页能降低首屏等待和内存占用，但也需要处理加载状态、刷新、错误、重复数据和列表边界。本文介绍分页数据流的设计和界面反馈方式。

一、确定分页键

分页数据源负责按页或游标读取一段数据。页键必须与服务端协议一致：如果接口返回下一页游标，就保存游标，而不是假设页码连续递增。刷新键应尽量让列表回到用户当前阅读的位置附近。

空页是否表示结束也要依据接口契约。若服务端提供下一页标识，应以该标识为准；不要猜测返回数量不足就一定没有后续数据。

二、选择数据来源

直接从网络分页适合简单、无需离线访问的内容。需要离线优先时，可将服务端结果写入本地数据库，由数据库观察流驱动列表。仓库负责协调刷新与本地读取，避免界面同时维护两份分页数据。

列表筛选条件变化时要创建对应的新数据流。搜索输入可先合并短时间内的连续修改，减少无用请求。

三、区分加载状态

首次加载可显示整页占位，追加加载可在列表底部显示进度，刷新失败则可以保留旧内容并显示重试入口。空列表和加载失败不能用同一种状态表达。

错误应转换成可操作的提示。网络中断、需要重新登录和服务暂不可用可能需要不同处理。不要吞掉异常并伪装成空数据。

四、处理重复与排序

刷新期间可能重新收到已有项目，去重应使用稳定主键，而不是标题等可变字段。偏移分页遇到新增内容时可能跳项；游标分页通常更稳健，但排序字段相同时仍需确定次级排序规则。

基于数据库的分页应有稳定排序和唯一键。插入、删除和筛选变化后，要确认列表不会出现重复或遗漏。

五、支持重试与刷新

追加失败后，重试应从失败页继续；用户主动下拉刷新则应使当前分页源失效并获取新内容。空状态重试、尾部重试和整页刷新代表不同操作语义，应有各自的反馈。

过多地复制分页数据会造成状态竞争。让分页组件作为列表数据来源，界面只处理展示和用户动作。

六、测试分页边界

使用确定性数据源覆盖第一页、空结果、末页、追加失败和刷新键。界面测试需要观察首次加载、尾部加载与保留旧内容时的呈现。也应模拟筛选快速变化后，旧请求晚于新请求返回的场景。

七、常见问题

1. 确认页码从零还是从一开始与服务端一致。
2. 不要在界面重组时反复创建分页器。
3. 检查筛选变化后旧列表是否及时失效。
4. 为项目提供稳定身份，避免插入时大范围重绘。
5. 不要把错误、空结果和加载中状态合并。

八、总结

分页设计的重点是可靠页键、清楚的加载状态、稳定排序和一致的数据来源。分别处理首次加载、追加失败和刷新错误，能让大列表在网络波动时保持可用。