DynamoDB SDK v3执行PartiQL批量语句报ValidationError如何解决

BatchExecuteStatementCommand 和 ExecuteStatementCommand 是DynamoDB PartiQL提供的两个定位完全不同的接口，校验规则存在本质差异：

• ExecuteStatementCommand 支持全量PartiQL语法，允许带非主键过滤条件的查询、范围查询、全表扫描类操作，因此你写的带filterKey过滤的语句可以正常执行。
• BatchExecuteStatementCommand 设计目标是批量执行单项目精确读写操作，单批最多支持25条语句，每条语句必须能通过主键精确定位到唯一一条数据，不支持任何查询/扫描类语义。因此接口强制要求每条SELECT语句的WHERE子句必须完整指定表主键的全部属性（仅分区键的表需指定分区键，分区键+排序键的复合主键表需同时指定两个键），且所有主键条件必须使用等于（=）做精确匹配，不能携带任何非主键属性的过滤条件，否则就会抛出你看到的ValidationError。

你的报错核心原因有两个可能：

1. 语句WHERE子句中携带了非主键属性filterKey的过滤条件，不符合批量接口的校验要求
2. 如果filterKey不是表的排序键，且你的表是复合主键结构，你还缺失了排序键的精确匹配条件

根据业务场景选择对应方案即可：

• 方案1：非主键条件查询场景直接放弃使用BatchExecuteStatementCommand
  该接口本身不支持查询语义，带过滤条件的查询直接用ExecuteStatementCommand单条执行，或者使用原生QueryCommand/ScanCommand配合FilterExpression实现即可，不存在绕过校验的方式。
• 方案2：已知待查询项完整主键时，调整语句适配批量接口规则
  把语句中所有非主键的过滤条件移除，仅保留完整主键的精确匹配条件，批量请求拿到返回结果后，在业务代码侧做二次过滤即可。示例代码如下：

  // 批量语句仅保留主键精确匹配，移除非主键的filterKey条件
  // 若为复合主键表，需要额外补充排序键的=匹配条件
  const statement = `
  SELECT *
  FROM "my-table"
  WHERE "partitionKey" = '1234'
  `
  const result = await dynamodbClient.send(new BatchExecuteStatementCommand({
    Statements: [
      { Statement: statement }
      // 最多可追加25条不同主键的精确匹配语句
    ]
  }))
  // 代码侧过滤符合filterKey要求的条目
  const targetItems = result.Responses.filter(resp => {
    return resp.Item?.filterKey?.S === '5678'
  })
  

• 方案3：如果filterKey本身就是表的排序键
  检查表结构中排序键的实际字段名，修正语句中的字段拼写错误，确保和表主键定义完全一致即可通过校验。

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