Python如何通过GSI主键与排序键查询DynamoDB及常见问题排查

方案一报错原因 #

代码存在括号匹配错误，直接截断了表达式的构造逻辑：
原代码中conditions.Key('url')).eq(url)这行，在Key('url')之后多写了一个右括号，导致后续的eq调用、条件拼接逻辑和query方法的参数解析完全错位，最终传入KeyConditionExpression的内容不是合法的表达式结构，SDK解析时因无法识别预期的字符串/字节格式抛出TypeError: expected string or bytes-like。
补充：该方案用到的conditions.Key需要提前从boto3.dynamodb.conditions导入为Key，未正确导入也会触发同类解析错误。

方案二报错原因 #

DynamoDB的查询规则明确要求：索引的分区键、排序键判断必须全部写入KeyConditionExpression，FilterExpression仅支持对非主键属性做结果后置过滤。
你将属于GSI排序键的date放到FilterExpression中，违反了规则限制，SDK直接拦截抛出Filter Expression can only contain non-primary key attributes。即便不触发报错，这种写法也会拉取全量匹配url的索引数据后再做过滤，读取成本高、性能差。

方案三无结果原因 #

字符串拼接形式的键条件表达式本身没有语法问题，查不到数据通常是两类配置不匹配导致：

• GSI的url、date属性的数据类型、存储格式和你传入的查询值完全不一致：比如GSI中date是字符串类型存储的'2024-05-20'格式，查询时传入了datetime对象、数字时间戳、带时分秒的字符串版本，会导致等值匹配完全不命中
• GSI的键配置和预期不一致：比如实际GSI的排序键并不是date字段，导致条件匹配不到任何条目

1. 提前导入依赖：

   import boto3
   from boto3.dynamodb.conditions import Key
   

2. 修正括号匹配问题，将两个键的等值判断全部写入KeyConditionExpression，用&拼接逻辑与条件：

   table = boto3.resource('dynamodb').Table('目标表名')
   query_response = table.query(
       IndexName='url-date-index',
       KeyConditionExpression=
           Key('url').eq(要查询的url值)
           & Key('date').eq(要查询的date值)
   )
   

3. 上线前的校验项：
   • 核对GSI的配置：确认url是索引分区键、date是索引排序键，属性名没有拼写错误
   • 核对值的匹配格式：确认传入的url、date的数据类型、字符串格式和GSI中存储的内容完全一致
   • 所有涉及GSI主键、排序键的判断全部放到KeyConditionExpression中，不要挪到FilterExpression里

内容的提问来源于stack exchange，提问作者João Koritar