使用Node.js SDK查询DynamoDB GSI返回null问题排查

我一眼就看出问题出在哪了——你把async/await和回调函数混用了，这就是导致查询没返回预期数据的核心原因！

为什么会出错？ #

DynamoDB Node.js SDK的query方法支持两种调用模式：

• 回调模式：传入回调函数，方法不会返回Promise
• Promise模式：不传入回调，方法返回Promise，此时可以用await等待结果

你现在同时用了await和回调函数，会导致：

1. await等待的是一个undefined（因为传了回调时query不会返回Promise），外层代码会直接往下走
2. 回调函数里的逻辑是异步执行的，等它拿到数据时，可能已经错过了响应时机，甚至会出现重复发送响应的问题
3. 回调里的错误也不会被外层的try/catch捕获，导致错误无法正确处理

修复后的代码（推荐用async/await） #

去掉回调函数，直接用await接收查询结果，这样能正确捕获数据和错误：

try {
  var queryParams = {
    IndexName: "gsi1-index",
    KeyConditionExpression: "gsi1 = :gsi1",
    ExpressionAttributeValues: {
      ":gsi1": userEmail,
    },
    TableName: usersTable,
  };
  // 去掉回调，直接用await接收Promise结果
  const userData = await ddb.query(queryParams).promise();
  if (userData.Count === 0) {
    return res.status(400).json({ data: "No information was found" });
  }
  return res.status(200).json(userData);
} catch (err) {
  return res.status(400).json(err);
}

额外排查点（如果修复后还是有问题） #

• 确认GSI的定义：检查gsi1是不是该GSI的分区键，并且GSI有没有投影你需要的属性（如果只需要主键，默认投影就够；如果需要其他属性，要确认投影设置）
• 验证userEmail的值：确保代码里的userEmail和你在控制台查询时用的字符串完全一致（注意大小写、空格、特殊字符）
• 检查IAM权限：确认你的SDK使用的IAM角色有dynamodb:Query权限，并且允许访问这个GSI
• 确认表名和索引名：检查usersTable和gsi1-index的拼写是否和控制台里的完全一致（DynamoDB的名称是大小写敏感的）

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