如何使用AWS SDK for JavaScript在Amazon DynamoDB中按分区键查询并解决返回null问题

1. 基础配置校验 #

• 确认环境变量process.env.TABLE_PARTS的取值和DynamoDB控制台的目标表名完全一致，注意大小写、拼写、特殊符号不能有偏差
• 确认二级索引createdBy-index已在目标表上创建完成，状态为活跃，且索引的分区键字段就是createdBy。刚创建的索引需要等待1-5分钟完成数据同步，未激活的索引无法正常返回查询结果
• 检查索引的投影配置：如果索引设置的是仅投影主键，那么查询返回的结果只会包含主键字段，不会返回其他属性，但不会导致整个返回值为null，你可以根据业务需求调整投影范围为所有字段。

2. 数据与查询条件校验 #

• 确认表中确实存在createdBy属性值为abus282jehbhwdubunids的记录，DynamoDB的字符串匹配是严格区分大小写、前后空格和特殊字符的，建议直接从控制台复制对应记录的createdBy值替换查询参数测试
• 确认createdBy属性的类型和你传入的参数类型完全一致：如果表中createdBy定义为数字类型，你传入字符串类型的查询值会完全匹配不到结果。

3. 代码与权限校验 #

• 给查询逻辑加上异常捕获，查看是否有权限或者参数错误被遗漏：

try {
  var params = {
      TableName: process.env.TABLE_PARTS,
      IndexName: "createdBy-index",
      KeyConditionExpression: "createdBy = :createdBy",
      ExpressionAttributeValues: {":createdBy": "abus282jehbhwdubunids"}
  }
  const data = await db.query(params).promise();
  console.log("原始查询返回：", data) // 先打印原始返回值
  res.send(data);
} catch (err) {
  console.error("查询报错：", err)
  res.status(500).send(err)
}

• 确认调用DynamoDB的IAM身份同时具备目标表和createdBy-index的dynamodb:Query权限，缺少索引的查询权限会导致查询失败
• 确认DynamoDB客户端初始化的区域和表所在的AWS区域完全一致，区域不匹配会查询到空的表空间，返回空结果
• DynamoDB原生query接口的返回结构为{ Items: [], Count: 0, ScannedCount: 0 }，不会直接返回null。如果最终拿到的data是null，大概率是后续业务代码的赋值逻辑修改了返回值，优先检查打印的原始返回值是否正常。

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