使用AWS SDK V3+TypeScript多列查询DynamoDB报错求助

原代码错误原因 #

1. QueryCommand用法违规：DynamoDB的Query操作仅支持基于分区键做精确匹配，最多搭配排序键做条件筛选，不能同时把三个列都放到KeyConditionExpression里——这违背了DynamoDB主键查询的规则，是报错的核心原因。
2. 属性值格式错误：使用@aws-sdk/client-dynamodb原生客户端时，ExpressionAttributeValues里的变量必须用DynamoDB类型结构体包裹（比如字符串要写成{S: 具体值}），原代码直接传type、dock等变量，未指定类型，会导致解析失败。
3. 变量赋值语法问题：let types: Record<string, NativeAttributeValue> = data = await...这种连续赋值写法容易引发变量未定义问题，也是Cannot read properties of undefined (reading '0')报错的可能诱因。

第二次代码的问题 #

你改用FilterExpression的思路虽能实现过滤，但存在两处明显错误：

• 类型标识大小写错误：:region对应的结构体键是小写s，必须改成大写{S: region}，DynamoDB对类型标识大小写严格敏感。
• FilterExpression是全表扫描后再过滤，数据量大时性能极差，不适合精准查询场景。

正确实现多列精准查询的方案 #

方案1：基于主键+过滤条件查询 #

如果表的主键是type（分区键），dock是排序键，可调整为以下写法，剩余列用过滤条件补充：

const client = new DynamoDB({region: "us-east-1"});
const params = {
  TableName: Tables.TYPES,
  ExpressionAttributeNames: {
      '#type': "type",
      '#dock': "dock",
      '#region': "region"
  },
  ExpressionAttributeValues: {
      ":type": {S: type},
      ":dock": {S: dock},
      ":region": {S: region}
  },
  KeyConditionExpression: '#type = :type AND #dock = :dock',
  FilterExpression: '#region = :region'
}

const data = await client.send(new QueryCommand(params));
const types = data.Items; // Query结果存放在Items数组中
console.log("Received data ", types);

方案2：创建全局二级索引（GSI） #

如果需要频繁基于这三个列查询，推荐创建包含这三个列的GSI：

• 将type设为GSI的分区键，dock和region设为排序键（或组合成复合排序键），之后就可以用Query针对GSI查询：

const params = {
  TableName: Tables.TYPES,
  IndexName: 'Type-Dock-Region-Index', // 你的GSI名称
  ExpressionAttributeNames: {
      '#type': "type",
      '#dock': "dock",
      '#region': "region"
  },
  ExpressionAttributeValues: {
      ":type": {S: type},
      ":dock": {S: dock},
      ":region": {S: region}
  },
  KeyConditionExpression: '#type = :type AND #dock = :dock AND #region = :region'
}

const data = await client.send(new QueryCommand(params));
const types = data.Items;
console.log("Received data ", types);

方案3：使用GetItem（仅适用于主键匹配场景） #

如果三个列是表的主键（注意DynamoDB主键最多支持分区键+排序键两部分），直接用GetItemCommand即可，但这种场景需要你的表结构本身符合主键设计规则。

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