DynamoDB 中如何将结束日期查询参数设为可选并实现条件查询？

现有修改的合理性 #

你将endTime从必填参数调整为string | null类型的可选入参，这个类型定义是完全符合需求的，没有问题。只需要在此基础上动态拼接查询表达式和对应参数值，就能顺利适配两种查询场景，不需要推翻现有代码的整体结构。

动态构建查询逻辑的核心实现 #

DynamoDB 的 Query 操作有固定规则：必须指定分区键（PK）的等值匹配条件，排序键（SK）的匹配条件可以根据业务逻辑灵活替换，完全支持你要的两种查询场景：

• 当存在有效endTime时：SK 匹配 BETWEEN 开始时间 AND 结束时间，查询指定时间闭区间内的数据
• 当endTime为空时：SK 匹配 >= 开始时间，查询从开始时间往后的所有数据

具体的代码改造可以分为两部分：

1. 动态拼接KeyConditionExpression

   // 固定不变的PK匹配条件
   const baseCondition = `${this.PK} = :pk`;
   // 根据endTime是否存在拼接对应的SK匹配规则
   const skCondition = endTimeISO
     ? `${this.SK} BETWEEN :starttime AND :endtime`
     : `${this.SK} >= :starttime`;
   // 组合为完整的查询条件
   const KeyConditionExpression = `${baseCondition} and ${skCondition}`;
   

2. 动态构建表达式参数值
   不要硬写所有参数值，否则当endTime不存在时，引用了未定义的:endtime变量会直接触发DynamoDB报错，需要按实际入参追加参数：

   const ExpressionAttributeValues = {
     ':pk': 分区键的实际取值,
     ':starttime': startTimeISO,
   };
   // 仅当存在有效endTime时，才追加对应的参数映射
   if (endTimeISO) {
     ExpressionAttributeValues[':endtime'] = endTimeISO;
   }
   

新手需要注意的细节 #

• 不要为了偷懒，在endTime为空时硬塞一个代表最大时间的字符串（例如9999-12-31T23:59:59.999Z）套用原来的BETWEEN逻辑。虽然这种写法能得到查询结果，但会增加不必要的扫描范围，直接用原生的SK >= 开始时间条件是DynamoDB最优的查询写法，性能更好。
• 你之前将时间转换为UTC ISO字符串的处理是正确的，ISO字符串的字典排序顺序和实际时间顺序完全对齐，直接做大小匹配不会出现顺序错乱的问题，不需要额外转成毫秒时间戳做比较。
• 如果后续接口入参的endTime可能传递undefined而非null，可以把类型定义调整为endTime: string | null | undefined，配合原有的判空逻辑不会出问题，也能避免TypeScript的类型校验报错。
• 现有的分页逻辑不需要做额外改动，不管查询范围是带结束时间的固定区间，还是从开始时间往后的全范围，DynamoDB基于LastEvaluatedKey的分页机制是通用的，翻页逻辑不需要调整。

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