DynamoDB复合主键查询遇参数类型不匹配：CLI有效Node.js无效

你遇到的Condition parameter type does not match schema type错误，核心原因是Node.js SDK里的参数格式和AWS CLI的JSON格式有细微差异，尤其是数据类型的声明逻辑。咱们一步步拆解修正：

先明确你的表结构 #

• 表名：Contributors
• 复合主键：哈希键UserId（数字类型N），排序键NoteId

错误根源 #

AWS CLI里的expression-attribute-values是用JSON字符串定义类型（比如{ ":UserId": {"N":"2"} }），但Node.js SDK分两种使用场景：如果用DocumentClient（更常用的简化版），不需要手动声明类型；如果用原始DynamoDB客户端，则必须严格匹配低级API的格式——很多人会在这里搞混导致类型不匹配。

正确的两种实现方式 #

方式1：使用DocumentClient（推荐，更简洁） #

DocumentClient会自动帮你映射数据类型，不用手动写{"N":"2"}这种格式：

const AWS = require('aws-sdk');
const docClient = new AWS.DynamoDB.DocumentClient();

const params = {
  TableName: 'Contributors',
  KeyConditionExpression: 'UserId = :UserId',
  ExpressionAttributeValues: {
    ':UserId': 2  // 直接传数字，DocumentClient自动转成N类型
  }
};

docClient.query(params, (err, data) => {
  if (err) {
    console.error("查询失败:", JSON.stringify(err, null, 2));
  } else {
    console.log("查询结果:", JSON.stringify(data, null, 2));
  }
});

方式2：使用原始DynamoDB客户端（需严格匹配类型） #

如果坚持用原始客户端，必须严格遵循DynamoDB低级API的格式，注意N类型的值必须是字符串形式的数字：

const AWS = require('aws-sdk');
const dynamodb = new AWS.DynamoDB();

const params = {
  TableName: 'Contributors',
  KeyConditionExpression: 'UserId = :UserId',
  ExpressionAttributeValues: {
    ':UserId': { N: '2' }  // 这里必须传字符串类型的数字，不能直接写2
  }
};

dynamodb.query(params, (err, data) => {
  if (err) {
    console.error("查询失败:", JSON.stringify(err, null, 2));
  } else {
    console.log("查询结果:", JSON.stringify(data, null, 2));
  }
});

常见坑点提醒 #

• 用DocumentClient时别画蛇添足写{ ":UserId": { N: '2' } }，否则SDK会把这个对象当成普通Map类型，触发类型不匹配。
• 原始客户端中，N类型的值必须是字符串，直接传数字2会报错。

选一种符合你SDK使用习惯的方式，应该就能解决这个问题了。

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