如何在AWS DynamoDB中实现任意页码的分页功能？

我正在创建一个由AWS API Gateway触发的DynamoDB Scan Lambda函数，想实现分页功能。我知道需要在响应中返回LastEvaluatedKey，后续将其用作ExclusiveStartKey，但这种方式没法实现指定页码的分页选择——因为不知道总页数，而且必须获取第1页才能知道第2页的起始位置。请问怎么解决这个问题，直接查询指定页码的条目？

简化版Lambda代码如下：

import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
import { DynamoDBDocumentClient, ScanCommand, type ScanCommandInput } from '@aws-sdk/lib-dynamodb';
import { type Handler, type APIGatewayProxyEvent, type APIGatewayProxyResult } from 'aws-lambda';

const client = new DynamoDBClient();
const docClient = DynamoDBDocumentClient.from(client);

export const handler: Handler = async (event: APIGatewayProxyEvent): Promise<APIGatewayProxyResult> => {
    const { queryStringParameters } = event;
    try {
        const page = queryStringParameters?.page || 1; // 从查询参数获取页码
        const pageSize = 5;

        // 定义Scan操作参数
        const params: ScanCommandInput = {
            TableName: 'Products',
            Limit: pageSize,
            ExclusiveStartKey: exclusiveStartKey // 如何定义这个值？
        };

        const { Items, LastEvaluatedKey } = await docClient.send(new ScanCommand(params));
        return {
            statusCode: 200,
            body: JSON.stringify({
                products: Items,
                nextPage: LastEvaluatedKey ? Number(page) + 1 : null // 如何定义nextPage？
            })
        };
    } catch (err) {
        // 错误处理
        return {
            statusCode: 500,
            body: JSON.stringify({ error: 'Internal server error' })
        };
    }
};

核心原因说明 #

DynamoDB是分布式NoSQL数据库，没有全局的行序索引，Scan操作是按底层存储的分区顺序遍历数据，不存在固定的“页码-数据”映射关系，也无法直接获取总数据量（除非全表扫描一次），所以原生Scan不支持直接跳转到指定页码。以下是几种可行的解决思路：

1. 接受游标式分页（推荐，符合DynamoDB设计） #

放弃页码跳转，改用基于LastEvaluatedKey的游标分页，前端提供“上一页/下一页”按钮，而非直接输入页码。这种方式性能最优，适合生产环境。

修改后的代码示例：

import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
import { DynamoDBDocumentClient, ScanCommand, type ScanCommandInput } from '@aws-sdk/lib-dynamodb';
import { type Handler, type APIGatewayProxyEvent, type APIGatewayProxyResult } from 'aws-lambda';

const client = new DynamoDBClient();
const docClient = DynamoDBDocumentClient.from(client);

export const handler: Handler = async (event: APIGatewayProxyEvent): Promise<APIGatewayProxyResult> => {
    const { queryStringParameters } = event;
    try {
        const pageSize = 5;
        // 从查询参数获取游标（即上一页返回的LastEvaluatedKey）
        const exclusiveStartKey = queryStringParameters?.lastEvaluatedKey 
            ? JSON.parse(decodeURIComponent(queryStringParameters.lastEvaluatedKey)) 
            : undefined;

        const params: ScanCommandInput = {
            TableName: 'Products',
            Limit: pageSize,
            ExclusiveStartKey: exclusiveStartKey
        };

        const { Items, LastEvaluatedKey } = await docClient.send(new ScanCommand(params));
        // 把LastEvaluatedKey编码后返回，方便前端传递
        const encodedLastKey = LastEvaluatedKey ? encodeURIComponent(JSON.stringify(LastEvaluatedKey)) : null;

        return {
            statusCode: 200,
            body: JSON.stringify({
                products: Items,
                hasNextPage: !!LastEvaluatedKey,
                lastEvaluatedKey: encodedLastKey
            })
        };
    } catch (err) {
        return {
            statusCode: 500,
            body: JSON.stringify({ error: (err as Error).message })
        };
    }
};

2. 预生成页码标记（适合静态/低更新数据） #

如果数据量小且更新不频繁，可以定期执行全表扫描，把每个页码对应的ExclusiveStartKey存储到另一个DynamoDB表（比如ProductPageMarkers），结构如下：

• 主键：pageNumber（数字类型）
• 属性：exclusiveStartKey（存储对应页码的起始键）

使用时，先从ProductPageMarkers查询目标页码对应的exclusiveStartKey，再传入Scan参数。注意要定时刷新这个标记表，否则数据更新后页码对应的数据会失效。

3. 内存分页（仅适合极小数据量） #

一次性全表扫描所有数据到Lambda内存中，然后在内存中做分页。这种方式简单但风险大，数据量大时会触发Lambda内存上限，且全表扫描性能极差，仅适合测试或数据量极少的场景。

示例代码片段：

// 全表扫描获取所有数据
const allItems = [];
let lastKey;
do {
    const params: ScanCommandInput = {
        TableName: 'Products',
        ExclusiveStartKey: lastKey
    };
    const { Items, LastEvaluatedKey } = await docClient.send(new ScanCommand(params));
    allItems.push(...Items);
    lastKey = LastEvaluatedKey;
} while (lastKey);

// 内存分页
const page = Number(queryStringParameters?.page || 1);
const pageSize = 5;
const startIndex = (page - 1) * pageSize;
const endIndex = startIndex + pageSize;
const paginatedItems = allItems.slice(startIndex, endIndex);

return {
    statusCode: 200,
    body: JSON.stringify({
        products: paginatedItems,
        totalPages: Math.ceil(allItems.length / pageSize),
        currentPage: page
    })
};

4. 改用Query配合GSI（如果有排序字段） #

如果数据有可排序的字段（比如createdAt），可以创建全局二级索引（GSI），然后用Query操作代替Scan。但即使这样，依然无法直接跳转到指定页码，只能通过游标分页，不过Query的性能比Scan好很多，适合需要按特定顺序分页的场景。

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