当已知分区键（partition key）和排序键（sort key）的前缀，但不掌握完整排序键时，可通过 dynamodb enhanced client 的 `sortbeginswith()` 条件实现精准范围查询，避免全表扫描或低效扫描操作。
在 DynamoDB 中，Query 操作要求必须指定分区键，而排序键的匹配方式决定了查询的灵活性与性能。若你使用的是 AWS SDK for Java v2 的 Enhanced DynamoDB Client（推荐用于新项目），不能仅传入分区键后调用 keyEqualTo()——该方法实际要求提供完整的主键（即 partition key + sort key 组合），因此会触发 The provided key element does not match the schema 错误。
正确做法是使用 QueryConditional.sortBeginsWith()，它允许你基于排序键的字典序前缀进行范围查询，前提是你的排序键设计支持语义化前缀（如 "KEY_SORT#Alice"、"KEY_SORT#Bob_2024" 等）。该操作仍属于高效 Query（而非低效 Scan），仅遍历同一分区下满足前缀条件的项，毫秒级响应且成本可控。
以下为完整示例代码（适配你提供的实体结构）：
// 假设 id = "23456"，且你想查找所有 sk 以 "KEY_SORT#User" 开头的记录
String partitionKey = String.format("KEY#%s", id);
String sortKeyPrefix = "KEY_SORT#User"; // 注意：必须与 getSk() 中的格式完全一致
QueryConditional condition = QueryConditional.sortBeginsWith(
Key.builder()
.partitionValue(partitionKey)
.sortValue(sortKeyPrefix) // ✅ 仅需前缀，无需完整 sort key
.build()
);
QueryEnhancedRequest request = QueryEnhancedRequest.builder()
.queryConditional(condition)
.build();
// 执行查询（table 为 DynamoDbTable 实例）
table.query(request).stream()
.map(Page::items)
.flatMap(List::stream)
.forEach(System.out::println); ⚠️ 关键注意事项：
- sortBeginsWith() 要求排序键必须是字符串类型（String），且前缀匹配基于 UTF-8 字典序；
- 分区键值（partitionValue）必须精确匹配，不可模糊；
- 若排序键含时间戳等动态后缀（如 "KEY_SORT#User#20240515T103022Z"），前缀 "KEY_SORT#User#" 仍可有效过滤；
- 避免在排序键中混用分隔符歧义（如 # 与 : 多重嵌套），建议统一使用 # 并在业务层严格规范格式；
- 如需更复杂条件（如范围区间、多条件组合），可结合 QueryConditional.and() 或改用 scan()（仅当必要且已加滤波器并预估成本）。
总结：sortBeginsWith() 是 DynamoDB 高效查询的核心能力之一，特别适合“按类别+模糊名称”“按用户+时间范围”等常见场景。只要排序键设计具备可预测前缀，即可在零额外索引开销下实现高性能检索。
