AWS SDK调用DynamoDB执行scan操作代码无结果但控制台UI查询正常

问题原因 #

• 最直接的代码错误：你定义的请求参数变量名为param，但调用dynamoDb.scan()方法时传入的是未定义的params变量，相当于没有传入有效查询条件，自然返回空结果。
• 若修正变量名后问题仍存在，还有以下几个常见诱因：
  1. 分页限制：DynamoDB的scan接口默认单次最多返回1MB数据，如果匹配数据在第一页之后，首次调用就会返回空，控制台查询会自动完成分页拉取所有匹配结果，但SDK默认不会自动分页。
  2. 传参格式不匹配：如果你使用的是原生DynamoDB客户端而非DocumentClient，需要给ExpressionAttributeValues的参数明确指定数据类型，直接传字符串会导致过滤条件失效。
  3. 字段类型不匹配：如果表中updatedAt字段存储的是数值类型的时间戳，你传入字符串格式的日期做比对，类型不匹配会导致过滤不到结果。
  4. 日期边界问题：如果updatedAt存储的是带时分秒的ISO格式字符串（比如2021-12-01T12:00:00Z），你传入的上界2021-12-02会把所有2021-12-02当天带时间的记录过滤掉，控制台可能自动补全了日期边界，所以能查到结果。
  5. 资源不匹配：SDK初始化时指定的AWS区域、操作的表和控制台操作的不是同一个资源，也会出现查询结果不一致的问题。

修复方案 #

• 第一步先修正变量名对应问题，同时根据你使用的客户端类型调整传参格式，示例代码如下：

// 变量名统一为params
var params = { 
  TableName: 'events-dev', 
  FilterExpression: '#user_id = :userid AND #dt BETWEEN :dt AND :dt1',
  ExpressionAttributeNames: { '#user_id': 'user_id', '#dt': 'updatedAt'},
  // DocumentClient 直接传值即可
  ExpressionAttributeValues: {
    ':userid': 'fc0c6610-e17f-444e-887a-e556f9d17853',
    ':dt': '2021-12-01',
    // 带时分秒的字符串格式可以把上界加1天，避免遗漏当天数据
    ':dt1': '2021-12-03'
  }
  // 原生DynamoDB客户端需要指定数据类型，用以下格式替换上面的ExpressionAttributeValues
  /*
  ExpressionAttributeValues: {
    ':userid': { S: 'fc0c6610-e17f-444e-887a-e556f9d17853' },
    ':dt': { S: '2021-12-01' },
    ':dt1': { S: '2021-12-03' }
  }
  */
}

dynamoDb.scan(params, (error, data) => {           
  if (!error) { 
    console.log('data==', data.Items)
    // 有LastEvaluatedKey说明还有下一页，需要携带该参数继续查询
    if(data.LastEvaluatedKey){
      params.ExclusiveStartKey = data.LastEvaluatedKey
      // 重新发起scan请求，拼接返回的Items
    }
  }
});

• 若变量名修正后仍无数据，按以下步骤排查：
  1. 确认SDK初始化的区域、操作的表名和控制台完全一致，检查调用账号是否有该表的scan权限。
  2. 核对表中updatedAt字段的类型，如果是数值时间戳，把:dt和:dt1的值改成对应日期的毫秒/秒级时间戳数值。
  3. 实现自动分页逻辑，直到返回结果中没有LastEvaluatedKey为止，合并所有页的Items获取全量匹配结果。

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