AppSync游标分页异常：无数据却返回非空nextToken

我之前也碰到过类似的AppSync游标分页异常情况，结合你的场景分析，这大概率不是你的操作问题，而是过滤逻辑与索引机制不匹配导致的，咱们一步步拆解：

核心原因：分页与过滤的执行顺序 #

AppSync在处理带过滤条件的游标分页时，执行逻辑是这样的：

1. 先基于表的主键索引（或你配置的全局二级索引GSI）按照分页规则取limit数量的条目
2. 再对这些条目应用过滤条件，返回符合要求的结果

如果你的3条COMPLETED状态的TODO，刚好不在主键索引的前10条里，就会出现这种情况：

• 首次查询取了主键索引的前10条，过滤后没有符合COMPLETED的，所以返回空items
• 但主键索引还有后续条目（哪怕过滤后只剩3条），所以返回非空的nextToken
• 第二次查询用nextToken取后续的索引条目，刚好包含那3条COMPLETED的，所以能返回正确结果

而PENDING状态的36条分布在多个索引分页里，首次查询的前10条里就有符合条件的，所以表现正常。

解决方法 #

1. 为过滤字段创建全局二级索引（GSI）—— 根本解决方案 #

这是最推荐的做法，让AppSync基于过滤字段的索引来分页，这样分页和过滤逻辑会对齐：
在你的Amplify Schema中，给status字段添加@index注解：

type Todo @model {
  id: ID!
  title: String!
  status: String! @index(name: "byStatus", queryField: "listTodosByStatus")
}

重新部署后端后，使用新生成的listTodosByStatus查询来按状态获取数据：

query listTodosByStatus($nextToken: String) {
  listTodosByStatus(limit: 10, nextToken: $nextToken, status: COMPLETED) {
    nextToken,
    items { id title status }
  }
}

这样分页会直接基于status的索引，首次查询就能返回所有符合条件的3条数据，且nextToken为null。

2. 临时 workaround：自动续查空页 #

如果暂时无法修改索引，可以在前端逻辑里做兼容：当首次查询返回空items但有nextToken时，自动发起下一页查询，直到拿到数据或者nextToken为null。不过这只是临时方案，长期来看还是索引优化更靠谱。

验证方法 #

你可以先执行不带过滤的listTodos查询，看看那3条COMPLETED的TODO在结果中的位置。如果它们确实排在第10条之后，就完全验证了咱们上面的分析。

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