Zapier Code模块中对象数组被拆分为独立键数组的问题

问题本质 #

该问题的核心成因，全部来自Zapier Code模块的默认输出规则，没有复杂的隐藏逻辑：

1. 当输出内容为包含同名字段的嵌套对象数组时，Zapier的输出Schema自动探测机制会递归拆解嵌套结构，把同名字段聚合成顶层独立扁平数组，也就是观察到的三个散列字段
2. 当Code模块直接返回多元素数组时，Zapier会把每个数组元素识别为一次独立的流程运行事件，触发逐对象循环，不会把整体数组当成单个数据块传递

平稳传递目标JSON的可行方案 #

• 优先方案：整段payload字符串化，单字段封包传递
  这是稳定性最高、不需要调整Zapier高级设置的通用方案，操作逻辑简单直接：

  1. 在Code模块内完成原本的按逗号拆分、同索引对象组装逻辑后，不要直接把组装好的spec对象数组作为顶层输出，而是把所有需要传给PDFMonkey的结构化内容，用JSON.stringify()序列化成字符串，绑定到一个自定义的顶层字段上，示例代码结构：

     // 原有业务逻辑：接收输入的三个初始数组、按逗号拆分、同索引组装spec对象
     const inputSpecCategory = inputData.specCategory || [];
     const inputSpecName = inputData.specName || [];
     const inputSpecDesc = inputData.specDescription || [];
     
     const builtSpecList = inputSpecCategory.map((categoryStr, index) => ({
       specCategory: categoryStr.split(','),
       specName: (inputSpecName[index] || '').split(','),
       specDescription: (inputSpecDesc[index] || '').split(',')
     }))
     
     // 核心改动：把完整payload封成字符串字段输出
     return {
       pdfmonkeyPayload: JSON.stringify({
         specs: builtSpecList,
         // 其他需要传递的业务字段可以继续放在这个对象里
         documentTitle: '产品规格单',
         generatedTime: new Date().toISOString()
       })
     }
     

  2. 在后续PDFMonkey步骤的输入配置中，找到这个pdfmonkeyPayload字段，不要直接拖拽使用，而是在需要传入结构化spec数组的输入框中，用JSON.parse({{对应Code步骤.pdfmonkeyPayload}})把字符串解析回原始结构化对象。整个过程中Zapier只会把这个字段当成普通文本传递，完全不会触发自动结构拆解，也不会因为返回多元素数组触发逐对象循环。

• 次选方案：手动锁定输出Schema，关闭自动字段探测
  如果不想多一步字符串解析的操作，可以通过手动定义Code模块的输出字段，强制Zapier保留嵌套结构：

  1. 第一次跑通Code、预览到正确的对象数组结构后，打开Code模块的设置页，找到「输出字段」的编辑入口
  2. 手动新增一个类型为「Object」的输出字段，把specList的完整嵌套结构（包含category、name、description的数组属性）作为这个对象字段的子属性定义好，不要使用Zapier自动生成的拆解后字段
  3. 手动保存Schema后，Zapier就会把整个定义好的Object字段当成单个独立数据块传递，不会再递归拆解内部的数组结构

避坑提醒 #

• 不要为了规避自动拆解，把原始结构重新拼成扁平键值对传递，很容易出现索引错位、字段值匹配错误的问题
• Code模块的返回值不要写成多元素数组形式（比如return [specObj1, specObj2]），否则不管结构是什么样，Zapier都会把每个数组元素拆成一次独立流程运行，触发不必要的循环
• 如果使用字符串化的方案，一定要在PDFMonkey的输入侧做一次字符串解析，不要把原始字符串直接传给PDFMonkey的模板字段，否则会传入转义后的文本内容而非结构化JSON。

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