Solr查询同时配置cursor与start等分页参数时的执行行为

首先明确核心规则：只要Solr请求携带了合法的cursorMark参数，分页逻辑会优先走游标逻辑，普通分页参数不会按常规规则生效，具体处理逻辑和运行表现分参数说明如下：

• start参数
  只要请求带了cursorMark（包括初始请求传cursorMark=*），Solr默认会直接忽略start的配置，内部强制将分页起始偏移设为0，不会抛出参数冲突异常，仅会在调试日志中记录参数忽略行为。
  版本差异表现：7.x及更早版本中，无论初始请求还是后续翻页请求传非0的start，都会被静默忽略；8.x及以上版本中，后续翻页请求（携带上一次返回的nextCursorMark）如果传非0start，会直接返回400错误，明确提示游标请求不支持设置大于0的start值。

• rows参数
  这是游标请求中唯一正常生效的分页大小参数，逻辑和普通分页一致，直接决定单次请求返回的文档条数。需要注意：游标标记是和排序规则、页大小绑定计算的，整个翻页流程中不能修改rows值，否则会直接返回参数错误。

• offset、limit参数
  这两个是分页参数的别名，不同查询解析器、输出写法里会用到：

  • offset是start的别名，处理逻辑和start完全一致，带游标时会被直接忽略，高版本下游标翻页传非0offset同样会报400错误
  • limit是rows的别名，处理逻辑和rows完全一致，会被当作页大小参数生效，翻页过程中同样不允许修改值

常见踩坑点：不少业务代码是从旧的start分页逻辑迁移到游标，代码里默认拼接的start/offset参数没删掉，会出现“明明设置了从第1000条开始取，结果返回的是第一页数据”的问题，因为Solr低版本是静默忽略参数，没有报错，排查成本很高。如果确定使用游标，最好主动从请求中移除start/offset参数，不要依赖Solr的自动忽略逻辑。

不同参数组合的实际运行表现 #

• 初始游标请求（cursorMark=*）+ 任意start/offset值（Solr 7.x及更早）：从排序结果第0位开始返回rows/limit指定条数的数据，start/offset不生效，正常返回nextCursorMark
• 初始游标请求 + 非0 start/offset值（Solr 8.x及以上）：直接返回400参数错误
• 游标翻页请求（携带历史返回的nextCursorMark）+ 任意非0 start/offset值（所有版本）：直接返回400错误，不执行查询
• 游标请求（无论初始/翻页）+ 合法rows/limit值：正常按指定页大小返回数据，翻页全程保持rows/limit值不变即可正常翻页
• 游标请求同时传rows和limit：两个值必须完全相等，否则会返回参数冲突错误

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