AWS AppSync JS Resolver执行UpdateItem时主键不匹配错误求助

我使用AWS AppSync的JavaScript Resolver更新DynamoDB数据时，收到以下错误提示：
The provided key element does not match the schema

Resolver请求代码 #

export function request(ctx) {
  const { username } = ctx.arguments.input;
  const { identity } = ctx;

  const now = util.time.nowISO8601();
  const user = `USER#${identity.claims.sub}`

  return {
    operation: "UpdateItem",
    key: util.dynamodb.toMapValues({ pk: user }),
    update: {
      expression: 'SET #username = :username',
      expressionNames: { '#username': 'username' },
      expressionValues: { ':username': { S: username } },
    }
}

CloudWatch请求函数评估日志 #

{
    "logType": "RequestFunctionEvaluation",
    "fieldName": "updateUsername",
    "resolverArn": "arn:aws:appsync:us-xxxx-2:xxxxx:apis/xxxxx/types/Mutation/resolvers/updateUsername",
    "functionName": "update_username_function",
    "fieldInError": false,
    "evaluationResult": {
        "operation": "UpdateItem",
        "key": {
            "pk": {
                "S": "USER#118b6520-80c1-7074-0ed5-616bf57fbc3b"
            }
        },
        "update": {
            "expression": "SET #username = :username",
            "expressionNames": {
                "#username": "username"
            },
            "expressionValues": {
                ":username": {
                    "S": "dfgdf"
                }
            }
        }
    },
    "parentType": "Mutation",
    "path": [
        "updateUsername"
    ],
    "requestId": "172905a5-a810-400d-9e65-55bdc8a23964",
    "context": {
        "arguments": {
            "input": {
                "username": "dfgdf"
            }
        },
        "prev": {
            "result": []
        },
        "stash": {},
        "outErrors": []
    },
    "errors": [],
    "graphQLAPIId": "ivxudb2wxfda7htbuk64eje66e",
    "functionArn": "arn:aws:appsync:us-east-2:637453376396:apis/xxxxxx/functions/xxxxxx"
}

响应评估日志片段 #

...
"error": {
        "message": "The provided key element does not match the schema (Service: DynamoDb, Status Code: 400, Request ID: L7GLI66HRS7H7GPA4TN3RT2F1FVV4KQNSO5AEMVJF66Q9ASUAAJG)",
        "type": "DynamoDB:DynamoDbException"
    },
...

参考的AWS官方示例代码 #

import { util } from '@aws-appsync/utils';

export function request(ctx) {
  const { id, direction } = ctx.arguments;
  const field = direction === 'UP' ? 'ups' : 'downs';

  return {
    operation: 'UpdateItem',
    key: util.dynamodb.toMapValues({ id }),
    update: {
      expression: `ADD ${field} :plusOne, version :plusOne`,
      expressionValues: util.dynamodb.toMapValues({ ':plusOne': 1 }),
    },
  };
}

export function response(ctx) {
  return ctx.result;
}

我已确认数据库中的主键名为pk且类型为字符串，请问是什么原因导致该错误？

问题原因及解决方法 #

核心原因 #

这个报错最常见的触发场景是：你的DynamoDB表使用了复合主键（分区键+排序键），但Resolver只提供了分区键pk，缺少排序键的值。很多表设计时会默认或有意添加排序键，哪怕你误以为只有单一分区键。

另外需确认两个细节：

1. 表的分区键名称是否完全匹配（含大小写）：DynamoDB属性名区分大小写，若表定义的是PK而非pk，也会触发该错误。
2. 若表确实是单一分区键，需确认传入的pk值类型是否与表定义完全一致（比如表定义是字符串，你传入了数字类型，但从日志看你的pk是字符串，这一点可以排除）。

解决步骤 #

1. 检查表的主键结构：登录AWS控制台进入DynamoDB页面，找到目标表，查看「结构」标签下的主键配置。如果显示「分区键」和「排序键」两个字段，说明是复合主键，UpdateItem必须同时提供两个键的值。
2. 补充排序键到Resolver的key中：假设表的排序键是sk，且对应用户的排序键值固定为USER_DETAILS，修改Resolver的key部分：

key: util.dynamodb.toMapValues({ pk: user, sk: 'USER_DETAILS' }),

3. 规范表达式值构造：建议统一使用util.dynamodb.toMapValues处理表达式值，避免手动构造DynamoDB类型格式，减少出错概率。将update部分的expressionValues修改为：

expressionValues: util.dynamodb.toMapValues({ ':username': username }),

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