【n8n教程】Sub-Workflow转换：让你的工作流更模块化、更高效

最新推荐文章于 2025-12-22 22:11:53 发布

原创最新推荐文章于 2025-12-22 22:11:53 发布 · 880 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#ai #人工智能 #ai编程 #AIGC

n8n教程专栏收录该内容

16 篇文章

订阅专栏

【n8n教程】Sub-Workflow转换：让你的工作流更模块化、更高效

📌 什么是Sub-Workflow？

Sub-Workflow（子工作流）是n8n中一个强大的功能，它允许你把一个大的、复杂的工作流分解成多个更小、可复用的工作流模块。想象一下，就像编程中的函数一样——你可以创建一个做特定事情的Sub-Workflow，然后在多个地方调用它。

点击获取最新AI资讯、n8n工作流、开发经验分享

Sub-Workflow的核心优势

特性	说明
模块化	把复杂逻辑拆分成独立的、易于维护的单元
复用性	同一个Sub-Workflow可以被多个主工作流调用
可读性	主工作流看起来更清晰，逻辑更容易理解
易于测试	可以独立测试每个Sub-Workflow的功能
性能优化	避免工作流过大导致的内存问题
执行独立性	Sub-Workflow执行不计入活跃工作流额度限制

🎯 前置条件

n8n 版本 1.97.0 或更高
已有一个可运行的n8n实例（云版本或本地部署）
了解基本的n8n节点和工作流概念

📋 第一步：选择要转换的节点

要将部分工作流转换为Sub-Workflow，首先需要选择合适的节点。选择是连续的，这意味着所有选中的节点必须形成一条完整的链路。

选择节点的5个关键规则

✅ 必须满足：

不能包含触发节点（Trigger Nodes）
- 触发节点是工作流的起点，如"Webhook"、"定时触发"等
- 子工作流会通过"Execute Sub-workflow Trigger"节点接收输入
最多只有1个输入节点
- 从工作流外部进入Sub-Workflow的连接只能来自一个节点
- 该节点可以有多个传入连接，但只能是单一输入分支
- 不能是"Merge"节点这样的多输入汇聚节点
最多只有1个输出节点
- Sub-Workflow向工作流外部输出的连接只能到一个节点
- 该节点可以有多个传出连接，但只能是单一输出分支
- 不能是"If"节点这样的分支节点
必须连续包含中间所有节点
- 如果你选择了节点A和节点C，那么连接两者的节点B也必须被选中
- 不能有"缺口"存在
内部连接必须完整
- 选中的节点之间必须有清晰的连接关系
- 不能有悬空或孤立的节点

❌ 常见的选择错误

错误示例1：包含触发节点
❌ Webhook → HTTP Request → Slack → Sub-Workflow
   (不能包含Webhook作为触发节点)

错误示例2：输入节点是Merge（多输入汇聚）
❌ API调用1 ─┐
           ├─→ Merge → Set → 子工作流 (错误：Merge不能作为Sub-Workflow输入)
  API调用2 ─┘

错误示例3：输出节点是If（条件分支）
❌ 子工作流 → If节点 ─→ 分支1 (错误：If节点有多个分支输出)
                  └→ 分支2

正确示例：
✅ HTTP Request → Set → Function → Slack
   (连续、清晰的单一链路，可安全转换为Sub-Workflow)

🔄 第二步：执行转换操作

转换Sub-Workflow的步骤非常简单：

操作步骤

在画布上选择要转换的节点
- 点击第一个节点
- 按住 Shift 键，点击最后一个节点（自动选中中间的所有节点）
- 或者单独点击每个节点，同时按住 Ctrl/Cmd 键
右键点击选中区域
- 在画布背景上右键
选择 "Convert to sub-workflow"
- 点击菜单中的这个选项
n8n自动为你完成以下工作：
- ✨ 创建一个新的Sub-Workflow
- ✨ 把选中的节点移到新工作流
- ✨ 在原工作流中插入"Execute Sub-workflow"节点
- ✨ 自动配置输入/输出参数
- ✨ 更新所有表达式引用

就这样！ 你的工作流现在变得更加模块化了。

⚙️ 第三步：配置Sub-Workflow的输入和输出

转换完成后，还需要手动配置数据类型约束，这对于确保数据传递的安全性和准确性非常重要。

配置Sub-Workflow的输入

打开新创建的Sub-Workflow，找到"Execute Sub-workflow Trigger"节点：

步骤：

双击"Execute Sub-workflow Trigger"节点
在"Input data mode"选择一种定义方式：

📝 三种输入定义模式

模式	说明	适用场景
Define using fields below	手动定义每个输入字段的名称和类型	数据结构清晰、字段明确的场景
Define using JSON example	提供一个JSON示例，n8n自动推断类型	输入数据格式复杂时
Accept all data	接收任何数据，不限制类型	快速原型化或兼容多种数据源

推荐做法：

{
  "customerName": "John Doe",
  "email": "john@example.com",
  "amount": 99.99,
  "isVIP": true
}

使用JSON示例，n8n会自动识别：

customerName → String
amount → Number
isVIP → Boolean

配置Sub-Workflow的输出

找到Sub-Workflow中的最后一个节点，添加"Return"（返回）节点来定义输出：

步骤：

在Sub-Workflow中添加一个"Edit Fields (Set)"节点
这个节点会自动标记为"Return"
定义你要返回给父工作流的字段
同样设置每个字段的数据类型

示例输出配置：

字段名: result
类型: Object

字段名: status
类型: String

字段名: timestamp
类型: DateTime

🔗 第四步：在父工作流中调用Sub-Workflow

现在回到原始工作流，查看新生成的"Execute Sub-workflow"节点：

调用Sub-Workflow

节点会自动显示Sub-Workflow定义的输入字段
- 根据子工作流的输入要求填入数据
- 可以使用表达式从其他节点映射数据

映射数据示例：

输入: customerName
值: {{ $node["HTTP Request"].json.name }}

输入: email
值: {{ $node["Previous Node"].json.contactEmail }}

可选：启用类型转换
- 勾选"Attempt to convert types"
- n8n会尝试自动转换数据类型

⚠️ 重要注意事项与限制

n8n的Sub-Workflow转换虽然强大，但有一些需要特别注意的地方：

1️⃣ 表达式函数需要特殊处理

使用 first()、last()、all() 这样的访问器函数时要特别小心：

// ❌ 这种写法在转换后可能不工作
{{ $node["previous"].json.items[0] }}

// ✅ 转换后会变成
{{ $node["previous"]_firstItem.json }}

n8n会自动添加后缀：

_firstItem - 获取第一条数据
_lastItem - 获取最后一条数据
_allItems - 获取所有数据

建议： 转换后务必检查表达式是否正确工作！

2️⃣ AI节点的特殊处理

如果Sub-Workflow包含AI工具类节点：

必须选择所有相关节点一起转换
可能需要为其他AI Agents复制共享节点
某些AI功能在Sub-Workflow中的表现可能与主工作流不同

3️⃣ 执行顺序版本

新的Sub-Workflow会默认使用 v1 执行顺序
与主工作流的执行顺序版本可能不同
可在Sub-Workflow设置中手动调整

4️⃣ itemMatching函数的限制

// ❌ 不支持：使用表达式作为索引
itemMatching({{ $node.previousNode.json.index }})

// ✅ 支持：只能使用固定数字
itemMatching(0)  // 第0项
itemMatching(1)  // 第1项

5️⃣ 错误会阻止调用

如果Sub-Workflow中存在任何运行错误
父工作流就无法调用它
必须先修复Sub-Workflow中的所有错误

💡 实战案例：完整的数据处理Sub-Workflow

现在让我们看一个实际的、可执行的工作流示例。这个工作流演示了：

如何从API获取客户数据
通过Sub-Workflow进行数据转换和验证
最后保存到数据库

📥 完整工作流JSON

{
  "name": "Customer Data Processing with Sub-Workflow",
  "nodes": [
    {
      "parameters": {
        "triggerEvents": [
          "form_submit"
        ]
      },
      "id": "webhook-trigger-a1b2c3",
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [
        100,
        140
      ]
    },
    {
      "parameters": {
        "url": "https://api.example.com/customers/{{ $node.Webhook.json.customerId }}",
        "method": "GET"
      },
      "id": "http-request-d4e5f6",
      "name": "Get Customer Data",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4,
      "position": [
        300,
        140
      ]
    },
    {
      "parameters": {
        "options": {}
      },
      "id": "execute-subworkflow-g7h8i9",
      "name": "Execute Sub-Workflow",
      "type": "n8n-nodes-base.executeWorkflow",
      "typeVersion": 1,
      "position": [
        550,
        140
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.example.com/customers",
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            {
              "name": "name",
              "value": "={{ $node['Transform Data'].json.cleanName }}"
            },
            {
              "name": "email",
              "value": "={{ $node['Transform Data'].json.email }}"
            },
            {
              "name": "status",
              "value": "={{ $node['Transform Data'].json.status }}"
            }
          ]
        }
      },
      "id": "http-save-j0k1l2",
      "name": "Save to Database",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4,
      "position": [
        800,
        140
      ]
    }
  ],
  "connections": {
    "webhook-trigger-a1b2c3": {
      "main": [
        [
          {
            "node": "Get Customer Data",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "http-request-d4e5f6": {
      "main": [
        [
          {
            "node": "Execute Sub-Workflow",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "execute-subworkflow-g7h8i9": {
      "main": [
        [
          {
            "node": "Save to Database",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

📤 Sub-Workflow JSON （数据转换与验证）

这个Sub-Workflow负责清理、验证和转换客户数据：

{
  "name": "Transform and Validate Customer Data",
  "nodes": [
    {
      "parameters": {
        "inputType": "defineBelow",
        "inputs": {
          "fields": [
            {
              "name": "firstName",
              "type": "string",
              "required": true
            },
            {
              "name": "lastName",
              "type": "string",
              "required": true
            },
            {
              "name": "email",
              "type": "string",
              "required": true
            }
          ]
        }
      },
      "id": "subwf-trigger-m3n4o5",
      "name": "When Executed by Another Workflow",
      "type": "n8n-nodes-base.executeWorkflowTrigger",
      "typeVersion": 1,
      "position": [
        100,
        140
      ]
    },
    {
      "parameters": {
        "assignments": [
          {
            "name": "cleanName",
            "type": "expression",
            "value": "{{ ($node['When Executed by Another Workflow'].json.firstName + ' ' + $node['When Executed by Another Workflow'].json.lastName).trim() }}"
          },
          {
            "name": "email",
            "type": "expression",
            "value": "={{ $node['When Executed by Another Workflow'].json.email.toLowerCase().trim() }}"
          },
          {
            "name": "status",
            "type": "string",
            "value": "active"
          }
        ]
      },
      "id": "set-transform-p6q7r8",
      "name": "Transform Data",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3,
      "position": [
        350,
        140
      ]
    },
    {
      "parameters": {
        "condition": "expression",
        "value": "={{ /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test($node['Transform Data'].json.email) }}"
      },
      "id": "if-validate-s9t0u1",
      "name": "Validate Email",
      "type": "n8n-nodes-base.if",
      "typeVersion": 1,
      "position": [
        550,
        140
      ]
    },
    {
      "parameters": {
        "assignments": [
          {
            "name": "cleanName",
            "type": "expression",
            "value": "={{ $node['Transform Data'].json.cleanName }}"
          },
          {
            "name": "email",
            "type": "expression",
            "value": "={{ $node['Transform Data'].json.email }}"
          },
          {
            "name": "status",
            "type": "string",
            "value": "active"
          }
        ]
      },
      "id": "set-return-v2w3x4",
      "name": "Return",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3,
      "position": [
        750,
        140
      ]
    }
  ],
  "connections": {
    "subwf-trigger-m3n4o5": {
      "main": [
        [
          {
            "node": "Transform Data",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "set-transform-p6q7r8": {
      "main": [
        [
          {
            "node": "Validate Email",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "if-validate-s9t0u1": {
      "main": [
        [
          {
            "node": "Return",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  ]
}

🚀 如何使用这个案例

导入主工作流JSON
- 在n8n中新建工作流
- 点击"Export"，选择"Import from JSON"
- 粘贴主工作流JSON
导入Sub-Workflow JSON
- 创建一个新工作流
- 粘贴Sub-Workflow JSON
- 保存并记下工作流ID
连接Sub-Workflow
- 回到主工作流
- 编辑"Execute Sub-Workflow"节点
- 选择刚才创建的Sub-Workflow
- 映射输入字段
测试工作流
- 通过Webhook发送测试数据
- 检查数据转换是否正确
- 验证是否成功保存到数据库