You need to enable JavaScript to run this app. AWS API Gateway中如何用Apache VTL实现JSON节点的非遍历式深拷贝?
优惠活动
大模型
产品
解决方案
定价
更多

AWS API Gateway中如何用Apache VTL实现JSON节点的非遍历式深拷贝?

问题根因

你遇到的嵌套节点被转成普通字符串的问题,并不是VTL不支持JSON深拷贝,完全是使用方式的偏差导致的:

  • 通过$input.path()读取到的嵌套节点是Java层面的JSONObject实例,只要把这个实例放在双引号包裹的字符串上下文里,VTL会自动调用对象的原生toString()方法输出,最终就会形成{UserID={S=xxx}}这种非JSON格式的字符串,和你看到的异常输出完全匹配。
  • 要把任意深度的JSON节点完整原样挂载到输出结构中,完全不需要手动遍历逐节点拼装,用AWS API Gateway内置的VTL工具就能实现等价的深拷贝效果。
零遍历实现嵌套JSON节点拷贝的方法

直接替换原来的item输出逻辑,不需要遍历任何子节点,完整支持任意深度的嵌套对象、数组结构:

  1. 去掉原来包裹目标节点的双引号,不要把JSON值放在字符串的上下文位置
  2. 用$input.json()方法替代$input.path()读取目标节点,这个方法会直接把路径对应的节点序列化为标准合法的JSON格式输出,不会触发对象原生toString()的非预期逻辑

修改后的完整requestTemplate写法:

#set($inputRoot = $input.path('$'))
{
  "TableName": "${tableName}",
  "ConditionExpression": "attribute_not_exists(TimeUTC) OR TimeUTC > :sk",
  "ExpressionAttributeValues": {
    ":sk": {
      "S": "$util.escapeJavaScript($input.path('$.time'))"
    }
  },
  "Item": $input.json('$.item'),
  "ReturnValues": "ALL_OLD",
  "ReturnConsumedCapacity": "INDEXES",
  "ReturnItemCollectionMetrics": "SIZE"
}

上面模板的核心改动就是把原来的"Item": "$input.path('$.item')"替换成不带引号的"Item": $input.json('$.item')。这种实现方式完全不需要遍历节点,不管item下有多少层嵌套对象、数组,都能一次性完整拷贝,没有额外的模板维护成本。

注意事项
  • 绝对不要给$input.json('$.item')的输出外层套双引号,一旦加了引号,序列化后的JSON内容会被自动转义,又变回带转义符的字符串值,回到最初的异常问题。
  • 如果目标节点可能为空,可以搭配内置工具做兜底处理,依然不需要遍历任何节点:
    "Item": $util.defaultIfNull($input.json('$.item'), '{}')
    
  • 这种方式对任意深度的嵌套结构都能完整拷贝,不存在层级丢失、内容截断的问题,完全匹配你需要“把item节点整体作为独立JSON挂载到Item字段下”的预期效果。

常见踩坑:不要在VTL输出的JSON结构里手动加多余的注释、冗余逗号或者非JSON格式字符,API Gateway的VTL引擎会严格校验输出的JSON合法性,格式错误会直接触发集成失败。


内容的提问来源于stack exchange,提问作者Jimson James

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 12:24:04