Step Function调用DynamoDB Query报错：缺少键架构元素Scope

核心问题1：Query操作误用非主键字段作为查询条件 #

DynamoDB的Query操作**仅支持针对表的主键（分区键+可选排序键）**构建KeyConditionExpression，而你的表中Scope并非主键架构的一部分，这直接触发了错误Query condition missed key schema element: Scope。

核心问题2：参数格式错误 #

使用Step Functions的aws-sdk:dynamodb:query资源时，参数不需要像原生DynamoDB API那样用{ "S": "值" }的类型封装格式，直接传入原始值即可。你当前的ExpressionAttributeNames和ExpressionAttributeValues格式不符合要求。

解决方案 #

根据你的需求，有两种可行方案：

方案1：改用Scan操作（适合数据量较小的场景） #

如果表数据量不大，可使用Scan操作配合FilterExpression过滤Scope字段：

"Obtain Users info": {
  "Type": "Task",
  "Parameters": {
    "TableName": "Users",
    "FilterExpression": "#Scope = :Global",
    "ExpressionAttributeNames": {
      "#Scope": "Scope"
    },
    "ExpressionAttributeValues": {
      ":Global": "Global"
    }
  },
  "Resource": "arn:aws:states:::aws-sdk:dynamodb:scan",
  "Next": "Pass"
}

方案2：创建全局二级索引（GSI）后使用Query（适合数据量大的场景） #

1. 给Users表创建全局二级索引，将Scope设为索引的分区键（记好索引名称，比如Scope-index）
2. 修改Step Function任务，指定索引名称进行Query：

"Obtain Users info": {
  "Type": "Task",
  "Parameters": {
    "TableName": "Users",
    "IndexName": "Scope-index", // 替换为你的GSI实际名称
    "KeyConditionExpression": "#Scope = :Global",
    "ExpressionAttributeNames": {
      "#Scope": "Scope"
    },
    "ExpressionAttributeValues": {
      ":Global": "Global"
    }
  },
  "Resource": "arn:aws:states:::aws-sdk:dynamodb:query",
  "Next": "Pass"
}

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