DynamoDB全局二级索引分页问题求助（Node.js环境）

我之前也碰到过完全一样的问题，核心原因是使用全局二级索引（GSI）查询时，分页用的ExclusiveStartKey必须严格匹配GSI自身的键架构，而非主表的键架构。咱们一步步拆解问题和解决方案：

问题根源分析 #

你的GSI time-index键架构是：

• HASH键：fixedKey（字符串类型）
• RANGE键：timestamp（数字类型）

DynamoDB返回的LastEvaluatedKey会同时包含主表主键（id）和GSI的键，这是为了确保能唯一定位数据，但对于GSI分页查询来说，id是多余的，甚至会引发错误：

1. 仅传入id作为起始键：缺少GSI必需的fixedKey和timestamp，直接触发The provided starting key is invalid错误。
2. 传入包含id的完整LastEvaluatedKey：GSI的键架构里根本没有id字段，因此提示The provided key element does not match the schema。

正确解决方案 #

1. 提取GSI专用的起始键 #

从返回的LastEvaluatedKey中，只保留GSI的两个核心键：fixedKey和timestamp，忽略主表的id字段。

2. 构建合规的分页查询参数 #

在后续分页请求中，将这两个字段作为ExclusiveStartKey传入，同时要注意类型必须和GSI定义一致（timestamp是数字类型，不能传字符串）。

修改后的代码示例：

let params = {
  TableName: process.env.importsTableName,
  IndexName: 'time-index',
  KeyConditionExpression: 'fixedKey = :fk',
  Limit: 5,
  ProjectionExpression: "timeBasedId, importFileS3Key, meta, #st, #ch, success, errors, #ty, #id, email",
  ScanIndexForward: true,
  ExpressionAttributeNames: {
    "#ch": "Attributes",
    "#st": "status",
    "#ty": "type",
    "#id": "identity",
  },
  ExpressionAttributeValues: {
    ":fk" : "fixedKey",
  },
};

// 处理分页参数：从queryStringParameters中提取有效键
const queryParams = event.queryStringParameters;
if (queryParams?.fixedKey && queryParams?.timestamp) {
  params.ExclusiveStartKey = {
    fixedKey: queryParams.fixedKey,
    timestamp: parseInt(queryParams.timestamp, 10) // 必须转为数字，匹配GSI中timestamp的N类型
  };
}

关键注意事项 #

• 严格匹配GSI键架构：GSI分页的起始键只能包含它自身定义的HASH和RANGE键，不能添加主表主键，也不能遗漏任何一个GSI键。
• 类型一致性：DynamoDB是强类型数据库，timestamp在GSI中定义为N（数字），因此从URL参数拿到的字符串必须转为数字，否则会因类型不匹配报错。
• 精简分页参数：前端分页时只需传递fixedKey和timestamp，无需传递id，减少不必要的参数传递。

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