Cosmos DB分页返回记录数翻倍：如何对含嵌套数组的文档使用OFFSET和LIMIT

问题根因 #

你遇到的返回结果数量远超LIMIT设置的核心原因是：当单个文档的arrayList同时匹配多个OR分支的ARRAY_CONTAINS条件时，查询的中间匹配条目会重复计数，OFFSET和LIMIT默认作用于中间匹配条目而非最终去重的外层文档，部分场景下未去重的查询还会直接返回重复的文档，最终导致返回结果数不符合预期。

修复方案 #

方案1：添加DISTINCT去重后分页 #

在查询中增加DISTINCT关键字，保证每个符合条件的外层文档仅保留一份，OFFSET/LIMIT会直接作用于去重后的结果集，即可准确返回10条记录：

SELECT DISTINCT * FROM collections c
WHERE ARRAY_CONTAINS(c.arrayList , {"Id":302 },true) OR ARRAY_CONTAINS(c.arrayList , {"Id":2 },true)
ORDER BY c._ts DESC 
OFFSET 10 LIMIT 10

方案2：改写查询逻辑避免重复匹配（更推荐） #

将多OR的ARRAY_CONTAINS写法替换为EXISTS+IN的形式，该语法匹配到数组内第一个符合条件的元素就会终止判断，天然不会产生重复匹配问题，不需要额外加DISTINCT，查询性能也更优：

SELECT * FROM collections c
WHERE EXISTS(
    SELECT VALUE arr FROM arr IN c.arrayList
    WHERE arr.Id IN (2, 302)
)
ORDER BY c._ts DESC 
OFFSET 10 LIMIT 10

注意事项 #

• 如果你的集合为跨分区部署，需要将ORDER BY用到的_ts字段加入索引策略的复合索引中，否则分页计数可能出现偏差，同时查询RU消耗会大幅上升。
• 若分页深度超过1000，建议改用延续令牌（Continuation Token）实现分页，性能远优于OFFSET/LIMIT的深度分页方案。

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