DynamoDB查询GSI时出现主键相关键错误问题求助

看起来你踩了DynamoDB GSI查询的几个常见坑！我来帮你梳理下问题所在和解决办法：

1. 忘记在查询请求中指定GSI名称 #

DynamoDB默认会使用主表的主键进行查询，如果你没有明确指定要使用的GSI，系统会尝试用主表的user键来匹配，自然会抛出主键相关错误。

正确做法：在Query/Scan请求中添加IndexName参数，指定你的GSI名称：

// 示例（AWS SDK v3）
const params = {
  TableName: "config.user_table",
  IndexName: "activation_code_index", // 关键：指定要使用的GSI
  KeyConditionExpression: "activation_code = :ac",
  ExpressionAttributeValues: {
    ":ac": { S: "your-target-activation-code" }
  }
};

2. 误用了仅支持主键的操作 #

像GetItem、DeleteItem、UpdateItem这类操作只能使用主表的主键，无法直接通过GSI的键来调用。如果你的代码里用了这些操作来查询GSI，必然会报错。

正确做法：查询GSI必须使用Query或Scan操作（优先用Query，因为Scan是全表扫描，性能较差）。

3. KeyConditionExpression指向了主表主键 #

如果你的查询语句里，KeyConditionExpression写的是主表的user键，而不是GSI的activation_code键，系统还是会尝试用主表主键逻辑处理，导致错误。

正确做法：确保KeyConditionExpression针对GSI的键（也就是activation_code）来写，比如上面示例中的activation_code = :ac。

额外检查项 #

• 确认GSI的状态是ACTIVE：你可以在AWS控制台的DynamoDB表详情页查看GSI状态，如果是CREATING或UPDATING，需要等待状态变为ACTIVE后再查询。
• 检查GSI的投影设置：如果你的查询需要返回user之外的其他属性，要确保GSI的Projection配置包含这些属性（可以设置为ALL，或者指定需要的属性），否则查询结果里只会包含GSI的键和投影的属性。

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