扣子工作流子工作流嵌套复用实战指南
将重复逻辑封装为子工作流，主流程一键调用
在扣子平台设计工作流时，一旦发现同一段校验逻辑反复复用，应立即将其抽离。具体操作分为四个关键步骤： 第一步：进入资源库，点击右上角「+」→「工作流」，创建一个独立工作流并命名为“通用订单校验”。**必须勾选「设为子工作流」**，否则后续无法被其他工作流引用，这是刚性前提。 第二步：在该新建工作流内，仅放置校验所需的节点——例如数据库查询订单是否存在、LLM节点判断超时状态、条件分支返回布尔值，最后接结束节点。特别注意：开始节点的输入参数名需明确定义，如沿用order_id，确保主流程传参时字段一一对应。 第三步：返回冗长的主工作流，在画布空白处搜索“工作流节点”并拖入，打开配置面板，在「选择子工作流」下拉列表中选取刚创建的“通用订单校验”。 第四步：在该工作流节点的输入映射区域，将主流程变量（例如{{input.order_id}}）拖拽至右侧对应字段。若子工作流定义了多个输入参数，此处必须全部匹配——任何缺失都会导致执行静默中断且无日志提示。子工作流调用时控制执行顺序与触发者身份
主流程与子工作流默认并行执行，但某些场景要求子流程完成后才能继续。例如校验失败时不得发送通知；另一些场景需让子流程看起来由“同一个人”操作，例如审批流中保留原始提交人信息。 第一种方式：勾选「子流程执行完毕后，再开始下一个节点」。此时主流程在该节点处暂停，等待子工作流返回结果后才进入下一步。若不勾选，两者完全异步，适用于日志记录、埋点上报等不影响主干逻辑的任务。 第二种方式：在子工作流节点配置中，勾选「传递触发者」。此时子工作流内的所有操作（如数据库写入、消息通知）的发起人显示为主流程的实际触发者，而非“工作流系统”。**不勾选时，审批记录会显示“系统自动执行”，人工审计时极易引发质疑。**批量数据传入子工作流的两种写法
若需对100条订单做批量校验，手动重复调用子工作流不现实——必须依赖结构化数据驱动。 常见方法有两种： 方法1：主工作流先通过代码节点或LLM节点组装数组，例如输出[{“order_id”:“20260605001”},{“order_id”:“20260605002”}]，然后将该数组整体传递至子工作流节点的输入字段。子工作流开始节点的输入类型需设为Array → Object，并在内部使用循环节点逐条处理。 方法2：用「循环节点」包裹子工作流节点。将原始数组接入循环节点，每次迭代取一条对象，再将此对象的order_id字段映射进子工作流节点。这种方式更直观，调试时可查看每条记录的独立执行日志。 需注意：若数组超过500条，建议使用方法1配合子工作流内的分批处理逻辑，避免单次调用超时。扣子对单次子工作流调用的执行时长有限制，超时直接终止且不重试。子工作流调试失败时快速定位问题
子工作流无法独立触发，因此不能像普通工作流那样点击「运行测试」——必须通过主工作流入口排查，但错误日志通常仅显示“子工作流执行失败”，无法定位具体出错节点。 一个实用的临时方案：取消子工作流的「设为子工作流」勾选，保存后手动运行一次，观察各节点输出。确认无误后再重新勾选。此操作直接在子工作流设置页顶部开关切换即可。 真正关键之处在于：子工作流开始节点必须至少有一个输入参数被主流程传入，否则整个节点会静默跳过，连日志都不会留下。若发现子工作流节点图标显示灰色，大概率是输入映射为空。