使用RediSearch FT.SEARCH时OFFSET超10000上限的绕过方案问询

当使用FT.SEARCH的LIMIT参数分页时，OFFSET超过10000会触发报错，以下是几种可行的解决办法：

1. 采用游标（CURSOR）分页（推荐） #

RediSearch官方推荐用游标分页替代OFFSET分页，这种方式没有10000的限制，且大数据量下性能更优。

使用方式：

• 首次查询传入CURSOR 0，指定每页数量（比如COUNT 100）：

  FT.SEARCH your-index "your-query" CURSOR 0 COUNT 100
  

• 命令返回结果的最后一个值是下一次查询的游标，将这个游标传入下一次查询，直到游标返回0表示所有结果已获取完毕。

用StackExchange.Redis实现的示例代码：

using StackExchange.Redis;

var redis = ConnectionMultiplexer.Connect("your-connection-string");
var db = redis.GetDatabase();
long cursor = 0;

do
{
    var response = await db.ExecuteAsync("FT.SEARCH", "your-index-name", "your-search-query", "CURSOR", cursor, "COUNT", 100);
    // 解析并处理查询结果
    // 提取下一个游标（返回结果的最后一个整数）
    cursor = response.OfType<RedisResult>().Last(r => r.Type == ResultType.Integer).ToObject<long>();
} while (cursor != 0);

2. 使用聚合查询（FT.AGGREGATE）的SCAN选项 #

如果需要对结果进行聚合处理，也可以用FT.AGGREGATE结合SCAN参数实现无限制分页：

FT.AGGREGATE your-index "your-query" SCAN 0 COUNT 100

同样通过返回的游标循环查询，直到游标为0。

3. 修改RediSearch的maxoffset配置（不推荐） #

可以通过修改RediSearch的maxoffset参数来提高OFFSET上限，但这种方式不建议使用：

• 启动Redis时添加参数：redis-server --loadmodule ./redisearch.so --maxoffset 20000
• 或者在redisearch.conf中设置maxoffset 20000

弊端：OFFSET越大，查询需要扫描的文档越多，性能会急剧下降，且占用更多服务器资源，大数据量场景下几乎不可用。

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