我们如何在 API 设计中执行分页？分页在 API 设计中对于有效处理大型数据集和提高性能至关重要。以下是六种流行的分页技术：
🔹基于偏移量的分页：此技术使用偏移量和限制参数来定义起点和要返回的记录数。 - 示例：GET /orders?offset=0&limit=3 - 优点：易于实现和理解。 - 缺点：对于较大偏移量可能效率低下，因为它需要扫描和跳过行。
🔹基于游标的分页：此技术使用游标（唯一标识符）来标记数据集中的位置。通常，游标是指向特定记录的编码字符串。 - 示例：GET /orders?cursor=xxx - 优点：对于大型数据集更有效率，因为它不需要扫描跳过的记录。 - 缺点：实现和理解稍微复杂一些。
🔹基于页面的分页：此技术指定页码和每页的大小。 - 示例：GET /items?page=2&size=3 - 优点：易于实现和使用。 - 缺点：对于大页码，与基于偏移量的分页存在类似的性能问题。
🔹基于键集的分页：此技术使用键来过滤数据集，通常是主键或另一个索引列。 - 示例：GET /items?after_id=102&limit=3 - 优点：对于大型数据集很高效，并避免了大偏移量引起的性能问题。 - 缺点：需要唯一的索引键，并且实现起来可能很复杂。
🔹基于时间的分页：此技术使用时间戳或日期对记录进行分页。 - 示例：GET /items?start_time=xxx&end_time=yyy - 优点：适用于按时间排序的数据集，确保在添加新记录时不会遗漏任何记录。 - 缺点：需要可靠且一致的时间戳。
🔹混合分页：此技术结合了多种分页技术以发挥它们的优势。示例：结合光标和基于时间的分页，以便高效滚动按时间排序的记录。 - 示例：GET /items?cursor=abc&start_time=xxx&end_time=yyy - 优点：可以为复杂数据集提供最佳性能和灵活性。 - 缺点：实施起来更复杂，需要精心设计。 – 订阅我们的每周新闻通讯以获取免费的系统设计 PDF（158 页）：https://blog.bytebytego.com/
🌟 总结
✅ 小规模数据 ➝ Offset-based / Page-based（简单，易实现）。
✅ 大规模数据 ➝ Cursor-based / Keyset-based（高效，减少性能损耗）。
✅ 时间序列数据 ➝ Time-based（适合日志 & 交易数据）。
✅ 最高效 & 灵活 ➝ Hybrid Pagination（适用于复杂业务需求）。
🎯 选择正确的分页技术，会让 API 更加高效，避免数据库查询瓶颈！
📌 最佳实践：
永远不要盲目使用 OFFSET，大数据集会让性能急剧下降！
推荐使用游标（Cursor）或者键集（Keyset）分页 来提高查询效率！
对于时间序列数据，最好结合时间戳和索引键！
