n8n 抽取子工作流：先确定输入输出，再处理跨节点引用

先为子流程起一个业务名字 把“验证客户地址”抽成子工作流，比把画布中间十个节点笼统搬走更容易复用。建议先写清它接受什么、成功返回什么、失败如何表示。若这段逻辑依赖外部某个节点的临时名称，却没有可解释的输入契约，先整理依赖再转换。 选区必须符合连接条件 官方的转换功能要求所选节点连续，不包含触发器，与外部连接最多通过一个开始节点和一个结束节点；入口、出口各自还受分支约束。选择范围应包含两端之间的全部节点。因此，一个混杂多路入口、并从中间多处向外输出的区域，不能只靠框选获得清晰的子流程。 建议先在原工作流标出进入和离开的字段，必要时拆成两个业务步骤。界面不允许转换时，先核对图结构，不急着删除连接让按钮变亮。 转换会处理引用，但验收仍由你完成 文档说明，引用外部节点的表达式会被更新并加入子流程触发器参数。这个自动处理能减少重复配置，却不意味着所有访问方式在新上下文中语义相同。first、last 和 all 涉及数据项顺序或集合，官方明确要求特别检查。 例如原流程的“第一条订单”可能是全批第一条，进入子流程后却只是本次输入集合的第一条。验收要给出多个客户、每人多笔订单，而不只传单条数据。 用两位客户验证“第一项”没有变成另一种含义 假设主流程收到 C01 的 O1、O2 和 C02 的 O3。要抽出的步骤是“检查这一批订单”，则子流程应接收明确的订单集合并返回逐单结果；若它的职责是“检查当前客户”，就应先按客户分组，再分别传入两位客户自己的订单。 用这组自拟数据对照转换前后的每个 order_id、customer_id 和结果。原表达式中的 first() 若指整个批次第一项，不能在每次客户调用中被解释为该客户第一项后还沿用旧业务逻辑。可把真正需要的全局值作为命名输入传入，使调用者明确提供，避免从子流程内部猜测外部顺序。 若结果包含错误记录，返回错误原因和对应订单身份，而不是只输出成功项让调用者以为整批已完成。子流程可独立运行通过后，再从主流程测试一次，检查输入映射和返回映射；独立样例不会覆盖主流程传错字段的问题。 补上类型约束 转换后的输入输出默认允许所有类型。官方要求使用者在触发器和返回用的 Edit Fields 节点中自行设置预期类型。建议把必要字段、空值和错误表示一并记录，使不同调用者能得到稳定契约。 如果某个可选字段缺失，应明确是使用默认值、返回业务错误，还是允许继续；不要让不同调用路径各自猜测。 AI 子节点与执行顺序 AI 工具等子节点需要完整选择，共享给其他 Agent 的节点可能要先复制。新子流程默认使用 v1 执行顺序，也应与原流程设置比较。这些差异与代码逻辑无关，却可能改变运行行为。 交付时保留一组主流程调用样例及子流程独立样例。两边都检查返回字段、条数和错误路径，再让其他工作流接入。

本篇涉及的工具1

n8n

将连续业务步骤转换为有明确输入输出的子工作流。

适合场景

已有大型 n8n 工作流，希望复用校验、查询或转换步骤的维护者。

需要留意

集合访问、类型约束及执行顺序需要在主子流程两侧复查。

了解项目 访问官网