Dynamoose与DynamoDB二级索引查询报错排查：ValidationException: Query condition missed key schema element

我来帮你拆解一下问题所在，其实核心是你的Global Secondary Index（GSI）配置和查询逻辑不匹配，导致DynamoDB无法识别你要查询的键结构。

问题根源分析 #

首先看你的Serverless表配置，你定义的VehicleLookupIndex这个GSI，它的KeySchema居然用了表的主键id作为HASH键，但你的Dynamoose模型里却把registration和derivativeId关联到了这个索引上——这两者完全不对应！

DynamoDB的Query操作必须基于主键（表主键或GSI主键）进行，你想通过registration和derivativeId查询，就必须让这两个字段成为GSI的主键（HASH/RANGE），而不是复用表的id。

分步修正方案 #

1. 修正Serverless中的GSI配置

首先要更新DynamoDB表的GSI定义，让它匹配你的查询需求：

cache:
  Type: AWS::DynamoDB::Table
  Properties:
    TableName: ${self:provider.stage}-${self:service}-cache
    AttributeDefinitions:
      - AttributeName: id
        AttributeType: S
      - AttributeName: registration  # 新增GSI HASH键的属性定义
        AttributeType: S
      - AttributeName: derivativeId  # 新增GSI RANGE键的属性定义
        AttributeType: S
    KeySchema:
      - AttributeName: id
        KeyType: HASH
    BillingMode: PAY_PER_REQUEST
    GlobalSecondaryIndexes:
      - IndexName: 'VehicleLookupIndex'
        KeySchema:
          - AttributeName: 'registration'  # 把registration设为GSI的HASH键
            KeyType: 'HASH'
          - AttributeName: 'derivativeId'  # 把derivativeId设为GSI的RANGE键
            KeyType: 'RANGE'
        Projection:
          NonKeyAttributes:
            - 'id'
            - 'createdAt'
            - 'updatedAt'
          ProjectionType: 'INCLUDE'

注意：必须在AttributeDefinitions里添加GSI用到的所有属性，否则CloudFormation部署会报错。

2. 修正Dynamoose模型的GSI定义

让模型和Serverless的表配置保持一致，不需要在derivativeId上单独声明索引，把它作为GSI的RANGE键关联到registration即可：

const schema = {
  types: {
    id: { type: String, required: true },
    registration: { 
      type: String, 
      index: { 
        name: 'VehicleLookupIndex', 
        global: true,
        rangeKey: 'derivativeId' // 明确指定RANGE键
      } 
    },
    derivativeId: { type: String }
  },
  options: {
    timestamps: true,
    saveUnknown: ['**'],
    expires: 10
  },
};

3. 修正查询代码，指定使用GSI

Dynamoose的Query默认会用表的主键（id）查询，你必须明确指定使用哪个GSI，同时用Dynamoose提供的null()方法来查询空值：

let value = 'dsadsada';
Cache.query('registration').eq(value)
  .where('derivativeId').null()
  .using('VehicleLookupIndex') // 关键：指定使用我们定义的GSI
  .exec();

额外注意事项 #

• 修改完配置后，一定要重新部署你的Serverless服务，让DynamoDB表的GSI更新生效；
• 尽量避免用Scan来实现这个需求，Scan会全表扫描，数据量大时性能极差，GSI+Query才是最优解。

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