使用GSI索引和FilterExpression查询AWS DynamoDB返回空结果的解决方法

你的查询返回空结果，核心问题出在查询逻辑和索引使用上，具体如下：

1. 无需额外创建GSI #

你的主表已经将ID设为分区键、receivedTime设为排序键，完全可以直接基于主表完成目标查询，额外创建GSI属于冗余操作，还会增加存储和读写开销。

2. 时间范围不能用FilterExpression #

DynamoDB的FilterExpression是在查询结果返回后做二次过滤，而排序键的范围查询必须放到KeyConditionExpression中——这是DynamoDB的核心查询规则：只有分区键等值匹配+排序键范围匹配，才能精准定位目标数据，否则要么查不到，要么性能极差。

正确的查询代码（直接使用主表） #

const params = {
  KeyConditionExpression: '#ID = :ID AND #receivedTime BETWEEN :startTime AND :endTime',
  ExpressionAttributeNames: {
    '#ID': 'ID',
    '#receivedTime': 'receivedTime',
  },
  ExpressionAttributeValues: {
    ':ID': 'ID2',
    ':startTime': 1670723188,
    ':endTime': 1673723188,
  },
  TableName: 'tableName',
};
const data = await docClient.query(params).promise();

这段代码会精准定位到ID=ID2且receivedTime在指定范围内的记录（即receivedTime=1670723198的那条数据）。

若坚持使用GSI（不推荐） #

如果一定要用你创建的Query-ID-index，必须确保索引满足两个条件：

• 分区键为ID，排序键为receivedTime
• 索引已投影receivedTime和Data属性（默认全投影则无需额外配置）

同时查询时仍需将时间范围放到KeyConditionExpression中，代码如下：

const params = {
  IndexName: 'Query-ID-index',
  KeyConditionExpression: '#ID = :ID AND #receivedTime BETWEEN :startTime AND :endTime',
  ExpressionAttributeNames: {
    '#ID': 'ID',
    '#receivedTime': 'receivedTime',
  },
  ExpressionAttributeValues: {
    ':ID': 'ID2',
    ':startTime': 1670723188,
    ':endTime': 1673723188,
  },
  TableName: 'tableName',
};
const data = await docClient.query(params).promise();

最后检查参数值是否正确：确认id变量确实传入ID2，时间戳类型与表中存储一致（表中存数字就传数字，别传字符串）。

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