DynamoDB查询GSI时特定范围键返回结果不完整的排查方法

• 检查分页是否完整：DynamoDB的query接口单次最多返回1MB数据，超出部分需要通过LastEvaluatedKey迭代获取后续结果。你的代码仅提取了首次返回的Items，如果缺失的400多条数据在后续分页中，就会出现查询结果不全的情况。可以用循环处理分页：

  items = []
  resp = table.query(IndexName='group_index', KeyConditionExpression=Key('group').eq('CLOUD') & Key('gsi_artificial_pk').eq(1))
  items.extend(resp['Items'])
  while 'LastEvaluatedKey' in resp:
      resp = table.query(IndexName='group_index', 
                        KeyConditionExpression=Key('group').eq('CLOUD') & Key('gsi_artificial_pk').eq(1),
                        ExclusiveStartKey=resp['LastEvaluatedKey'])
      items.extend(resp['Items'])
  # 再次检查目标id是否存在
  [x for x in items if x['id'] == '18962']
  

  控制台会自动处理分页展示全部结果，这是最可能导致差异的原因。

• 验证数据类型匹配：你查询时使用的是Python整数1，但实际item中的gsi_artificial_pk是Decimal('1')。虽然boto3通常会自动转换类型，但偶尔会出现匹配异常。尝试用Decimal类型构造查询条件：

  from decimal import Decimal
  resp = table.query(IndexName='group_index', KeyConditionExpression=Key('group').eq('CLOUD') & Key('gsi_artificial_pk').eq(Decimal(1)))
  

• 确认索引定义正确性：检查group_index的键结构，确保分区键是group、排序键是gsi_artificial_pk，没有定义错误。同时确认索引的投影类型为ALL（如果需要返回完整item属性），避免因投影限制导致数据无法被查询到。

• 排查索引一致性延迟：DynamoDB GSI采用最终一致性，虽然控制台能查到数据，但SDK查询可能刚好在同步完成前执行。可以等待几分钟后重新查询，或者检查主表写入过程是否有异常（比如写入失败未捕获，导致GSI未同步更新）。

• 升级SDK版本：旧版本的boto3/botocore可能存在类型处理或查询逻辑的bug，尝试升级到最新版本：

  pip install --upgrade boto3 botocore
  

• 检查请求参数细节：确认查询时没有额外设置Limit参数限制返回数量，也未添加FilterExpression过滤掉目标数据。

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