DynamoDB Between查询始终返回null，求排查代码问题

我想要查询满足第一个属性值完全匹配，且第二个属性值处于指定日期范围内的记录，但该查询始终返回无结果，尽管我能在数据表中看到符合条件的有效记录。关于Between操作符的使用资料较少，想请教我的代码是否存在错误？

原代码 #

var filter = new QueryFilter();
filter.AddCondition(primaryAttribute, QueryOperator.Equal, primaryValueToSearch);
filter.AddCondition(secondaryAttribute, QueryOperator.Between, rangeBegin, rangeEnd);
QueryOperationConfig config = new QueryOperationConfig{IndexName = primaryAttribute+"-"+secondaryAttribute+"-index", Filter = filter};
var result = await _dynamoDbContext.FromQueryAsync<TracedRecord>(config, _dynamoDbOperationConfig).GetRemainingAsync();
return result;

问题分析与修正 #

你的代码核心错误在于混淆了DynamoDB Query操作中KeyCondition和Filter的作用：

• DynamoDB的Query操作必须通过KeyCondition指定主键/索引键条件：你使用的是复合索引（primaryAttribute为分区键，secondaryAttribute为排序键），这类索引的查询条件必须放在KeyCondition中，而不是Filter。Filter是对Query返回的结果集进行二次过滤，无法利用索引的检索能力，甚至会导致索引完全未被正确触发。
• 排序键的Between范围查询必须属于KeyCondition：针对索引排序键的范围查询（比如日期区间），必须作为KeyCondition的一部分，这样DynamoDB才能利用索引的排序特性快速定位到目标区间的数据。

修正后的代码 #

var keyCondition = new QueryFilter();
keyCondition.AddCondition(primaryAttribute, QueryOperator.Equal, primaryValueToSearch);
keyCondition.AddCondition(secondaryAttribute, QueryOperator.Between, rangeBegin, rangeEnd);

QueryOperationConfig config = new QueryOperationConfig
{
    IndexName = $"{primaryAttribute}-{secondaryAttribute}-index",
    KeyCondition = keyCondition // 替换为KeyCondition而非Filter
};

var result = await _dynamoDbContext.FromQueryAsync<TracedRecord>(config, _dynamoDbOperationConfig).GetRemainingAsync();
return result;

额外排查点 #

如果修正后仍无结果，建议检查：

• 确认目标索引的状态为ACTIVE，且确实包含primaryAttribute和secondaryAttribute两个属性
• 验证日期参数rangeBegin和rangeEnd的格式、时区与数据库中存储的完全一致（比如是否都是UTC时间，字符串格式是否匹配）
• 确保rangeBegin的时间早于或等于rangeEnd，DynamoDB的Between操作要求起始值不大于结束值

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