Step Function中DynamoDB无结果错误处理问题求助

问题根源 #

当DynamoDB GetItem未查询到数据时，返回结果中没有$.Item字段，而你在ResultSelector里直接引用了$.Item.status.S这个不存在的JSONPath，触发了Step Functions的**States.Runtime系统级错误**。这类错误如果没有在Catch块中明确指定，默认不会被捕获，导致状态机直接失败。

具体解决方案 #

方案1：精准捕获States.Runtime错误

修改你的DynamoDB GetItem状态的Catch配置，明确指定捕获States.Runtime错误，同时可保留对DynamoDB服务错误的捕获：

{
  "Type": "Task",
  "Resource": "arn:aws:states:::dynamodb:getItem",
  "Parameters": {
    "TableName": "YourTable",
    "Key": {
      "id": { "S.$": "$.inputId" }
    }
  },
  "ResultSelector": {
    "status.$": "$.Item.status.S"
  },
  "ResultPath": "$.result",
  "Catch": [
    {
      "ErrorEquals": ["States.Runtime"],
      "Next": "FallbackLambda"
    },
    {
      "ErrorEquals": ["DynamoDB.ResourceNotFoundException"],
      "Next": "FallbackLambda"
    }
  ],
  "Next": "NormalProcessing"
}

这样当ResultSelector解析失败时，就能触发回退到FallbackLambda。

方案2：提前判断Item是否存在（更稳健）

在执行ResultSelector转换前，先通过Choice状态判断$.Item是否存在，从根源上避免Runtime错误：

1. 先移除DynamoDB状态中的ResultSelector和ResultPath，保留原始输出
2. 新增Choice状态判断结果：

{
  "Type": "Choice",
  "Choices": [
    {
      "Variable": "$.Item",
      "IsPresent": true,
      "Next": "TransformResult"
    }
  ],
  "Default": "FallbackLambda"
}

3. 在TransformResult状态中用Pass类型完成ResultSelector的转换：

{
  "Type": "Pass",
  "ResultSelector": {
    "status.$": "$.Item.status.S"
  },
  "ResultPath": "$.result",
  "Next": "NormalProcessing"
}

这种方式完全避开了Runtime错误的触发，逻辑更清晰。

方案3：使用JSONPath默认值语法

Step Functions的JSONPath支持||设置默认值，即使路径不存在也不会报错：

"ResultSelector": {
  "status.$": "$.Item.status.S || 'NOT_FOUND'"
}

之后再通过Choice状态判断$.result.status是否为NOT_FOUND，如果是则跳转到FallbackLambda。

注意事项 #

• States.Runtime是Step Functions的系统错误类型，必须在Catch块中明确指定才能被捕获，不能只依赖DynamoDB的服务错误类型
• 优先选择方案2，因为它从流程上规避了错误触发，比事后捕获更可靠

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