使用AWS Step Functions向DynamoDB存入嵌套全量JSON的实现问题

• Step Functions 对接 DynamoDB PutItem 的集成逻辑，要求传入的条目参数必须严格匹配 DynamoDB 底层 API 格式，每个值都需要显式附带对应的类型标记（如S、M、L）
• 你之前使用的"whole_payload": {"M.$": "$"}写法，仅会把最外层的whole_payload字段标记为M类型，对内部嵌套的所有对象、数组、标量值不会自动附加对应类型标记，因此存在多层嵌套结构时，会因入参格式不合法执行失败，表现为仅支持单层Map结构。

方案1：使用内置递归类型转换函数（零额外资源，最适配需求） #

Step Functions 提供专属内置函数States.DynamoDB.JSONToAttributeValue，可递归遍历任意深度的原生JSON结构，自动完成所有嵌套层级的DynamoDB类型映射，和DocumentClient的自动转换效果完全一致。
直接替换原有错误写法即可，示例PutItem任务定义片段：

"PutDynamoDBItem": {
  "Type": "Task",
  "Resource": "arn:aws:states:::dynamodb:putItem",
  "Arguments": {
    "TableName": "你的目标DynamoDB表名",
    "Item": {
      "partitionKey": {"S.$": "$.id"},
      "whole_payload.$": "States.DynamoDB.JSONToAttributeValue($)"
    }
  },
  "End": true
}

该函数的自动映射逻辑覆盖所有DynamoDB支持的数据类型：

• 原生JSON对象 → 自动标记为M类型
• 原生JSON数组 → 自动标记为L类型
• 字符串、数字、布尔、空值 → 自动标记为对应的S、N、BOOL、NULL类型
• 嵌套深度无限制，不需要手动遍历结构逐次标注类型

方案2：使用SDK集成模式调用DynamoDB #

如果需要更灵活的入参控制，可以将任务切换为AWS SDK原生调用模式，搭配内置转换函数即可实现同等效果。
示例任务结构：

"PutDynamoDBItem": {
  "Type": "Task",
  "Resource": "arn:aws:states:::aws-sdk:dynamodb:putItem",
  "Arguments": {
    "TableName": "你的目标DynamoDB表名",
    "Item": {
      "partitionKey": {"S.$": "$.id"},
      "whole_payload.$": "States.DynamoDB.JSONToAttributeValue($)"
    }
  },
  "End": true
}

• 内置转换函数不需要额外配置IAM权限，只要任务本身的IAM角色拥有目标DynamoDB表的PutItem权限即可正常执行
• 转换过程支持任意层级的嵌套Map、数组结构，和DocumentClient的自动映射行为完全匹配

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