带筛选条件的GraphQL查询未返回全部预期结果

嘿，我之前也碰到过类似的情况，咱们一步步来排查你这个问题——AppSync只返回3条记录，但DynamoDB里明明有263条包含"safe"的条目。下面是几个最可能的原因和对应的解决办法：

1. 先检查DynamoDB的索引配置 #

AppSync的list查询依赖DynamoDB的全局二级索引（GSI）来高效执行过滤操作。如果location_search_name没配置成合适的索引字段，contains过滤根本扫不到所有数据：

• 登录AWS控制台进入DynamoDB表，查看索引标签页，确认是否存在包含location_search_name的GSI。
• 如果没有对应的GSI，需要新建一个：把location_search_name设为排序键（分区键可以选固定值或常用字段），并且投影属性要包含location_name和你需要返回的所有字段（建议选“全部投影”避免遗漏）。
• 如果已有GSI，检查投影类型是否覆盖了location_search_name和location_name，否则AppSync无法获取到过滤所需的字段。

2. 注意contains是大小写敏感的！ #

DynamoDB的contains操作严格区分大小写。你查询用的是"safe"，但数据里的location_search_name可能是"Safe"、"SAFE"或混合大小写的形式，这会直接漏掉大部分匹配记录：

• 先试试把查询关键词改成大写或首字母大写，比如contains: "Safe"，看看是否能返回更多结果。
• 如果需要彻底不区分大小写的查询，建议写入数据时就把location_search_name统一转成小写（或大写）存储，查询时也使用相同的大小写格式，这样就能全量匹配到了。

3. 确认字段名完全一致 #

Amplify有时候会自动转换字段命名（比如把GraphQL的驼峰式转成DynamoDB的蛇形，或者反过来），你得确认DynamoDB里的实际字段名就是location_search_name：

• 直接查看DynamoDB表中的几条数据，核对字段名有没有拼写错误、大小写不一致的情况。
• 如果字段名不匹配，要么修改查询中的字段名，要么调整GraphQL schema和Amplify配置，让两边命名统一。

4. 排查分页限制（可能性低，但可以确认） #

AppSync的list查询默认最多返回100条记录，但你只拿到3条，这个概率不大，但可以快速确认下：

• 查看查询结果里是否有nextToken字段，如果存在，说明还有数据未返回，可以通过添加nextToken参数翻页：

  query MyQuery($nextToken: String) {
    listDirectoryListings(filter: {location_search_name: {contains: "safe"}}, nextToken: $nextToken) {
      items {
        location_name
      }
      nextToken
    }
  }
  

  不过如果实际有263条数据，第一页应该能返回100条，所以这个大概率不是主要原因，但排查下也没坏处。

5. 检查Resolver的自定义逻辑 #

如果你的listDirectoryListings resolver有自定义的VTL模板或者Lambda函数，可能里面加了额外的过滤条件，把结果限制住了：

• 进入AppSync控制台，找到该查询的resolver，查看请求模板和响应模板，确认是否添加了额外的过滤规则（比如固定的分区键限制）。
• 如果是Lambda resolver，检查代码里是否对查询结果做了额外筛选，不小心把大部分数据过滤掉了。

6. 确认数据同步状态 #

要保证DynamoDB里的263条记录都符合查询要求：

• 如果部分记录是直接通过DynamoDB控制台或其他SDK写入的，确认这些记录都包含location_search_name字段，且格式与Amplify生成的记录一致。
• 检查是否有DynamoDB触发器（比如Lambda）在写入数据时修改了location_search_name字段，导致部分记录的字段值不符合查询条件。

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