DynamoDB Query无报错但未返回存在记录：FilterExpression问题排查

核心问题 #

你的代码存在两个关键错误导致无法返回预期记录：

• 错误获取查询结果：DynamoDB的QueryCommand返回匹配的多条记录是Items数组，但你用const { Item }解构，而返回结构中不存在Item字段，导致始终拿不到数据。
• 冗余的手动数据类型包装：AWS SDK v3的QueryCommand支持直接传入原生JavaScript类型，无需手动包装成{ S: "xxx" }的低级API格式，手动包装可能因格式不匹配导致查询失效。

修正后的代码 #

const { unmarshall } = require("@aws-sdk/util-dynamodb");
const { QueryCommand } = require("@aws-sdk/client-dynamodb");

const getRecords = async (event) => {
  console.log("get specific Record")
  try {
    const dog = event.pathParameters.dogid;
    const user = event.queryStringParameters.userId;
    const params = {
      TableName: tableName,
      ExpressionAttributeNames: {
        "#dogId": "dogId",
        "#userId": "userId"
      },
      ExpressionAttributeValues: {
        ":dogId": dog,
        ":userId": user
      },
      KeyConditionExpression: "#dogId = :dogId",
      FilterExpression: "#userId = :userId"
    };
    // 获取查询返回的Items数组
    const { Items } = await dbClient.send(new QueryCommand(params));

    console.log("Items :", Items);
    // 反序列化所有记录后返回，无数据则返回空数组
    return Items ? Items.map(item => unmarshall(item)) : [];
  } catch (e) {
    console.error(e);
    throw e;
  }
};

额外优化建议 #

• 优化查询性能：如果按userId查询的频率较高，建议创建全局二级索引（GSI），将dogId设为GSI分区键、userId设为排序键，避免Query后过滤带来的性能损耗（尤其当dogId下数据量较大时）。
• 增加参数校验：对dogid和userId做非空校验，避免因参数缺失触发无效查询。

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