DynamoDB删除预订报错：提供的键元素与架构不匹配求解决

问题描述 #

删除用户特定日期和时间的预订时，触发DynamoDB错误：The provided key element does not match the schema，无法完成删除操作。

相关代码 #

Lambda处理代码 #

const AWS = require("aws-sdk");
const dynamo = new AWS.DynamoDB.DocumentClient();
exports.handler = (event, context, callback) => {
    let body;
    let response;

    switch (event.routeKey) {

        case 'DELETE /bookings/{user_name}/{restaurant_name}/{time}/{date}':
            //have to specify date and time because user might make reservation on same date,same restaurant, at 2 different timings
            var params = {
                TableName: 'hearty_eats_bookings',
                Key: {
                    'user_name': event.pathParameters.user_name,
                    'restaurant_name': event.pathParameters.restaurant_name,
                    'time': event.pathParameters.time,
                    'date': event.pathParameters.date
                },
            };

            dynamo.delete(params, function(err, result) {
                if (err) throw err;
                return callback(null, { "message": "booking cancelled" });
            });
            break;


        default:
            throw new Error("Unsupported route: " + event.routeKey);

    }
}

关键信息提取 #

Event JSON参数 #

请求路径参数包含：

• user_name: testuser
• restaurant_name: testrestaurant
• time: 12:00
• date: 2024-05-20

错误信息 #

Error: The provided key element does not match the schema
    at Request.extractError (.../aws-sdk/lib/protocol/json.js:52:27)
    at Request.callListeners (.../aws-sdk/lib/sequential_executor.js:106:20)
    // 调用栈省略

DynamoDB表结构 #

• 表名：hearty_eats_bookings
• 主键配置：
  • 分区键（Partition Key）：user_name（字符串类型）
  • 排序键（Sort Key）：booking_id（字符串类型）
• 其他属性：restaurant_name、time、date为非主键的普通属性

问题根源 #

DynamoDB的DeleteItem操作要求Key参数必须严格匹配表的主键结构（分区键+排序键，若表定义了排序键）。当前代码传入了非主键字段（restaurant_name、time、date），同时缺少了必填的排序键booking_id，导致与表的主键 schema 不匹配，触发报错。

修复方案 #

方案1：修改API路由，传入booking_id #

调整API路径为DELETE /bookings/{user_name}/{booking_id}，直接使用主键执行删除：

case 'DELETE /bookings/{user_name}/{booking_id}':
    const params = {
        TableName: 'hearty_eats_bookings',
        Key: {
            'user_name': event.pathParameters.user_name,
            'booking_id': event.pathParameters.booking_id
        }
    };
    dynamo.delete(params, function(err, result) {
        if (err) throw err;
        return callback(null, { "message": "booking cancelled" });
    });
    break;

方案2：保留现有路由，先查询再删除 #

如果需要保留原API路径，先通过user_name+其他条件查询出对应的booking_id，再执行删除：

case 'DELETE /bookings/{user_name}/{restaurant_name}/{time}/{date}':
    // 1. 查询获取目标预订的booking_id
    const queryParams = {
        TableName: 'hearty_eats_bookings',
        KeyConditionExpression: 'user_name = :user',
        FilterExpression: 'restaurant_name = :rest AND time = :t AND date = :d',
        ExpressionAttributeValues: {
            ':user': event.pathParameters.user_name,
            ':rest': event.pathParameters.restaurant_name,
            ':t': event.pathParameters.time,
            ':d': event.pathParameters.date
        }
    };

    dynamo.query(queryParams, function(queryErr, queryResult) {
        if (queryErr) throw queryErr;
        if (queryResult.Items.length === 0) {
            return callback(null, { "message": "Booking not found" });
        }
        // 2. 提取booking_id执行删除
        const bookingId = queryResult.Items[0].booking_id;
        const deleteParams = {
            TableName: 'hearty_eats_bookings',
            Key: {
                'user_name': event.pathParameters.user_name,
                'booking_id': bookingId
            }
        };
        dynamo.delete(deleteParams, function(deleteErr, deleteResult) {
            if (deleteErr) throw deleteErr;
            return callback(null, { "message": "booking cancelled" });
        });
    });
    break;

优化建议 #

如果频繁需要通过user_name+restaurant_name+time+date进行查询/删除操作，建议给表创建全局二级索引（GSI），将user_name设为GSI分区键，restaurant_name+time+date组合为GSI排序键（或单独作为索引字段），可以提升查询效率，避免全表扫描。

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