如何按需抑制AWS Step Functions的JSONPath表达式警告

问题背景 #

我用AWS Step Functions编排调用多个Lambda的工作流，部分Lambda的Payload需要包含JSONPath表达式字符串——Lambda自身会用这些表达式从DynamoDB记录中提取字段。但最近Step Functions编辑器针对这些字符串弹出误报警告，提示要让平台在运行时解析它们，而我不需要这个解析功能，想知道怎么抑制这类警告。

警告内容 #

您的状态机定义存在Amazon States Language警告，请检查确认状态机将按预期执行。
'isAuthorisedFirmFlow'的值看起来像JSONPath。请使用'isAuthorisedFirmFlow.$'替代'isAuthorisedFirmFlow'，以在运行时将其作为JSONPath计算。/States/Try/Branches[0]/States/Application Data Worker/Parameters/Payload/attributes
更多信息，请查看Amazon States Language

触发警告的ASL定义 #

"Application Data Worker": {
      "Type": "Task",
      "Resource": "arn:aws:states:::lambda:invoke",
      "Parameters": {
        "FunctionName.$": "States.Format('gateway-{}-dataprocessor-applicationdata-lambda:$LATEST', $.environment)",
        "Payload": {
          "attributes": {
            "intactApplicationId": "$.intactApplicationId",
            "firmId": "$.entities.applicationFirm.firmId",
            "ARN": "$.intactApplicationReferenceNumber",
            "contactId": "$.entities.applicationContactDetails.contactId",
            "firmName": "$.entities.applicationFirm.name",
            "effectiveDateOfChange": "$.entities.fdaFirmDetails.effectiveDateOfChange",
            "contactFirstName": "$.entities.applicationContactDetails.firstName",
            "contactLastName": "$.entities.applicationContactDetails.lastName",
            "contactEmail": "$.entities.applicationContactDetails.emailAddress",
            "submittedDate": "$.submittedDate",
            "submittedUserId": "$.submittedUserId",
            "registeredName": "$.entities.fdaFirmDetails.name",
            "registeredNameSnapshot": "$.entities.fdaFirmDetailsSnapshot.name",
            "hasARDetailsChecked": "$.entities.fdaFirmDetails.hasARDetailsChecked"
          },
          "applicationId.$": "$.applicationId",
          "userId.$": "$.userId",
          "correlationId.$": "$.correlationId"
        }
      },
      "Retry": [
        {
          "ErrorEquals": [
            "States.ALL"
          ],
          "IntervalSeconds": 60,
          "MaxAttempts": 4,
          "BackoffRate": 3
        }
      ],
      "Next": "Intact Application Worker",
      "ResultPath": "$.applicationDataResult",
      "ResultSelector": {
        "applicationData.$": "$.Payload.data"
      }
    },

抑制警告的有效方法 #

Step Functions编辑器会自动识别以$开头的字符串为潜在JSONPath表达式，从而触发警告。要避免这种误报，需要让编辑器将这些内容识别为普通字符串，而非待解析的表达式，具体有两种方式：

方法1：拆分结构用States.Format构造JSONPath #

通过Step Functions内置的States.Format函数拆分JSONPath结构并拼接成完整字符串，绕开编辑器的检测逻辑。修改后的attributes字段示例：

"attributes": {
  "intactApplicationId.$": "States.Format('$.{}', 'intactApplicationId')",
  "firmId.$": "States.Format('$.entities.applicationFirm.{}', 'firmId')",
  "ARN.$": "States.Format('$.{}', 'intactApplicationReferenceNumber')",
  // 其余字段按相同逻辑修改
}

方法2：直接用States.Format包裹完整JSONPath #

如果不想拆分结构，也可以直接用格式化函数包裹完整的JSONPath字符串，明确告诉编辑器这是普通字符串：

"attributes": {
  "intactApplicationId.$": "States.Format('{}', '$.intactApplicationId')",
  "firmId.$": "States.Format('{}', '$.entities.applicationFirm.firmId')",
  // 其余字段同理修改
}

注意事项 #

• 两种方法都不会改变最终传递给Lambda的Payload内容，运行时生成的字符串和原JSONPath完全一致。
• 绝对不要直接给字段加. $后缀并赋值原始JSONPath（比如intactApplicationId.$: "$.intactApplicationId"），这会让Step Functions在运行时解析该表达式，导致传递给Lambda的是解析后的值而非原始字符串。

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