使用dynamodb-geo查询DynamoDB时遇Query key condition不支持错误求助

问题根源 #

你遇到的ValidationException: Query key condition not supported错误，核心原因是GSI的结构不符合dynamodb-geo的要求，尤其是缺少必要的排序键，或者键类型配置错误。

修复步骤 #

1. 重新配置GSI（geohash-index） #

必须严格按照以下要求创建全局二级索引：

• 索引名称：geohash-index（名称必须完全匹配，不能自定义）
• 分区键：geohash，数据类型选择Number（dynamodb-geo内部以数值格式存储地理哈希值，String类型会导致查询条件不兼容）
• 排序键：hashKey，数据类型选择String（这是dynamodb-geo查询半径时必须的范围条件字段，你之前未设置排序键是关键错误）
• 投影类型：选择全部投影（ProjectionType: ALL），确保查询能返回所需的餐车数据

2. 确认数据插入方式 #

确保所有餐车位置数据是通过dynamodb-geo的putPoint方法插入的，而不是手动写入DynamoDB。因为putPoint会自动生成geohash（数值型）和hashKey（字符串型）字段，这两个字段是GSI正常工作的前提。示例插入代码：

myGeoTableManager.putPoint({
  RangeKeyValue: { S: 'vendor-123' }, // 对应你的表分区键vendor-id
  GeoPoint: {
    latitude: 30,
    longitude: -90
  },
  PutItemInput: {
    Item: {
      // 其他餐车属性，比如名称、地址等
      'vendor-name': { S: 'Downtown Taco Truck' }
    }
  }
}).then(() => console.log('位置数据插入成功'))

3. 验证代码配置 #

检查你的代码中hashKeyLength设置是否和GSI的逻辑匹配：

config.hashKeyLength = 5

这个值决定了hashKey的生成长度，只要保持和插入数据时的配置一致即可，你的当前配置没问题。

4. 重新执行查询 #

完成GSI配置和数据验证后，重新运行你的查询代码，应该能正常获取1公里范围内的餐车数据。

额外说明 #

• DynamoDB的GSI创建后需要等待一段时间才能生效（通常几分钟），如果刚创建完就查询，可能会出现数据不一致或报错，建议等待索引状态变为ACTIVE后再测试。
• 如果你的表中已有手动插入的数据，需要通过putPoint方法重新写入，或者手动添加geohash（数值）和hashKey（字符串）字段，否则这些数据不会出现在GSI中，无法被查询到。

内容的提问来源于stack exchange，提问作者Abdur-Rahman Sharif