AWS Lambda执行DynamoDB带过滤条件的Scan操作返回空结果问题排查求助

看起来你的DynamoDB Scan过滤逻辑遇到了典型的「扫到了数据但匹配不到」问题——ScannedCount: 12说明确实遍历了表中的12条数据，但FilterExpression没命中任何项。我帮你梳理几个最可能的原因和排查步骤：

1. 检查数据类型是否严格匹配 #

DynamoDB是强类型数据库，字符串、数字、布尔值等类型是完全区分的。比如：

• 如果表中title字段存储的是字符串类型，但你传入的event.queryStringParameters.title是数字类型（API可能自动转换了参数类型），就会匹配失败；
• 反过来，如果表中是数字，你传了字符串，同样不会有结果。

排查方法：

• 打印参数的类型：console.log("Title param type:", typeof event.queryStringParameters.title)；
• 去DynamoDB控制台查看目标记录的title字段类型（比如是S字符串还是N数字），确保两者类型完全一致。

2. 注意字符串的精确匹配规则 #

DynamoDB的字符串过滤是完全精确匹配的，任何细微差异都会导致匹配失败：

• 大小写敏感：比如表中是"Hello World"，你传"hello world"不会匹配；
• 前后空格：如果API传入的参数带了首尾空格（比如" My Title "），但表中存储的是"My Title"，也会匹配失败；
• 特殊字符：比如换行符、全角字符等肉眼不易察觉的差异。

排查方法：

• 先把DynamoDB控制台中第一条记录的title值完整复制出来，作为测试参数传入，看是否能匹配；
• 对参数做去空格处理：修改ExpressionAttributeValues为{ ":title": event.queryStringParameters.title.trim() }。

3. 修正代码中Promise与回调混用的问题 #

你当前的代码同时使用了回调函数和.promise()，这会导致逻辑混乱：.promise()返回的Promise会处理扫描结果，而传入的回调函数会被忽略，你在回调里打印的日志可能根本不会执行，影响调试准确性。

修正后的代码：

try {
  const params = { 
    TableName: event.queryStringParameters.TableName, 
    ExpressionAttributeValues: { ":title": event.queryStringParameters.title.trim() }, 
    FilterExpression: "title = :title", 
  }; 
  // 统一使用Promise风格，去掉冗余的回调
  const data = await dynamo.scan(params).promise();
  console.log("Scan Success", data);
  data.Items.forEach(element => {
    console.log("Matched title:", element.title);
  });
  body = data;
} catch (err) {
  console.log("Scan Error", err);
  body = { error: err.message };
}

4. 确认字段名完全一致 #

DynamoDB的属性名是区分大小写的，比如如果表中实际存储的字段是Title或TITLE，而你的FilterExpression写的是title = :title，就会匹配失败。

排查方法：

• 去DynamoDB控制台查看表的属性定义，确保过滤条件中的字段名和表中的属性名完全一致（包括大小写）。

5. 用GetItem验证单条记录 #

如果以上步骤都没解决问题，可以先用GetItem直接获取已知存在的记录，确认其title值的真实形态，再用这个值作为过滤参数测试Scan：

// 替换成你第一条记录的主键（比如id字段）
const getParams = {
  TableName: event.queryStringParameters.TableName,
  Key: {
    id: "your-record-primary-key"
  }
};
const getItemData = await dynamo.getItem(getParams).promise();
console.log("GetItem result title:", getItemData.Item.title);
// 用这个打印出来的title值作为参数传入Scan，看是否能匹配

按照上面的步骤逐一排查，大概率能找到问题所在——通常都是数据类型、字符串匹配或字段名的细微差异导致的。

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