如何让DynamoDB查询的ExclusiveStartKey使用精确匹配？

我正在用DynamoDB开发基于Node.js的Serverless RESTful API，API支持通过limit和lastKey查询参数实现键分页。

现有表格结构如下：

其中PK是分区键，SK是排序键，我用SK做分页。

• 正常场景：调用http://somewhere/api/school?limit=1&lastKey=secondSchool时，查询的ExclusiveStartKey为{"PK" : "School", "SK" : "secondSchool"}，返回结果是{"PK" : "School", "SK" : "thirdSchool"}，运行符合预期。
• 异常场景：调用http://somewhere/api/school?limit=1&lastKey=seco时，查询的ExclusiveStartKey为{"PK" : "School", "SK" : "seco"}，却得到了和上面完全相同的结果。

看起来DynamoDB没有对ExclusiveStartKey中的SK值做精确匹配，有没有办法强制DynamoDB对ExclusiveStartKey使用精确匹配？

测试代码如下：

const { DynamoDBClient } = require("@aws-sdk/client-dynamodb");
const { DynamoDBDocument } = require("@aws-sdk/lib-dynamodb");

const ddbClient = new DynamoDBClient({
  region: AWS_REGION,
  endpoint: AWS_DYNAMODB_END_POINT,
  credentials: {
    accessKeyId: AWS_ACCESSKEY_ID,
    secretAccessKey: AWS_SECRET_ACCESS_KEY,
  },
});

const ddbDocClient = DynamoDBDocument.from(ddbClient);

(async () => {
  try {
    const data = await ddbDocClient.query({
      TableName: "Table Name",
      KeyConditionExpression: "#pk = :pk",
      ExpressionAttributeNames: {
        "#pk": "PK",
      },
      ExpressionAttributeValues: {
        ":pk": "Test",
      },
      Limit: 1,
      ExclusiveStartKey: { PK: "Test", SK: "Seco" },
    });
    console.log(data);
  } catch (err) {
    console.log("Error", err);
  }
})();

首先明确：DynamoDB的ExclusiveStartKey本身就是精确匹配主键的参数，但你的问题出在对它的作用逻辑理解有误。

现象原因 #

ExclusiveStartKey的作用是告诉DynamoDB：从大于该主键的条目开始返回结果（排序键默认升序）。当你传入SK: "seco"时，在PK: "School"分区下，所有SK值比"seco"大的条目里，第一个就是"secondSchool"，接着取limit=1的结果自然是"thirdSchool"——这和传入SK: "secondSchool"的返回逻辑一致，因为"secondSchool"本身也大于"seco"，最终返回的都是下一个条目。

实现精确匹配的分页起始点 #

要实现“只有当lastKey是表格中真实存在的SK值时，才返回后续分页数据”，需要在构造ExclusiveStartKey前先做校验：

1. 用getItem请求验证传入的lastKey对应的条目是否存在
2. 若存在，再用该真实主键作为ExclusiveStartKey执行分页查询
3. 若不存在，直接返回空结果或错误提示，避免不符合预期的分页数据

示例校验逻辑代码：

async function getPaginatedSchools(lastKey, limit) {
  // 先验证lastKey对应的条目是否存在
  const existCheck = await ddbDocClient.get({
    TableName: "Table Name",
    Key: { PK: "School", SK: lastKey }
  });

  if (!existCheck.Item) {
    // 不存在则返回空结果或自定义错误
    return { Items: [], LastEvaluatedKey: null };
  }

  // 存在则执行分页查询
  const paginatedData = await ddbDocClient.query({
    TableName: "Table Name",
    KeyConditionExpression: "#pk = :pk",
    ExpressionAttributeNames: { "#pk": "PK" },
    ExpressionAttributeValues: { ":pk": "School" },
    Limit: limit,
    ExclusiveStartKey: { PK: "School", SK: lastKey }
  });

  return paginatedData;
}

额外优化建议 #

• 不要让前端传入原始SK字符串作为lastKey，而是直接返回查询结果中的LastEvaluatedKey（DynamoDB自动返回的完整主键对象），前端传递该值作为分页参数，可完全避免不匹配问题。
• 若必须让前端传入SK字符串，后端一定要做存在性校验，确保只有合法的SK值才能作为分页起始点。

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