DynamoDB带FilterExpression的Query未返回预期数据问题排查

关键误解：DynamoDB Query的Limit执行时机 #

你之前对执行顺序的理解有误，DynamoDB Query的实际流程是：

1. 依据KeyConditionExpression定位到目标分区（pk=1122），并按照ScanIndexForward指定的排序键顺序读取数据
2. 先读取Limit条符合KeyCondition的原始记录
3. 对这Limit条记录应用FilterExpression过滤
4. 返回过滤后符合条件的结果（如果这Limit条里没有匹配项，就返回空集合）

结合你的场景解释 #

假设你的表中pk=1122的记录结构与演示数据一致（sk从ID#01到ID#06，对应code为空、空、空、alex@000、alex@001、alex@001）：

• 当ScanIndexForward=false（降序读取，优先返回sk值最大的记录）：读取的1条记录是ID#06，其code=alex@001满足过滤条件，因此返回结果
• 当ScanIndexForward=true（升序读取，默认行为，优先返回sk值最小的记录）：读取的1条记录是ID#01，其code为空，不满足过滤条件，因此返回空

你提到开启ScanIndexForward后查询正常，应该是之前手动设置了ScanIndexForward=false，切换回默认的true时，刚好读取到了满足过滤条件的记录（可能你的实际数据中升序序列里的前几条就有符合code=alex@001的条目）。

注意事项与解决方案 #

要避免这类问题，可采取以下方式：

• 优化表结构：将过滤字段code整合到排序键中，比如设计sk为ID#xxx#alex@001，这样KeyConditionExpression就能直接定位到符合条件的记录，无需依赖FilterExpression
• 增大Limit值：让DynamoDB读取足够多的原始记录，确保其中包含满足过滤条件的条目
• 使用分页查询：通过LastEvaluatedKey循环查询，直到找到符合条件的数据

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