【n8n教程】：Switch节点，实现工作流多路由控制

在n8n自动化流程中，最常见的需求之一就是根据数据的不同条件，将其分发到不同的处理路径。如果你只需要处理”是”或”否”两种情况，可以用If节点；但当你需要根据多个条件创建3条、5条甚至更多的处理路径时，Switch节点就是你的最佳选择。

Switch节点就像是一个交通指挥官，它根据你设定的条件规则，将传入的数据准确地引导到对应的输出分支，让复杂的工作流变得清晰有序。

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

Switch节点是n8n中的条件路由节点，它允许你根据数据的属性值进行多路由决策。与If节点只能分出两条路（真/假）不同，Switch节点可以创建无限个输出分支，每个分支对应一组特定的条件。

核心特性：

• 多路由支持：不限制输出分支数量，想要多少就创建多少
• 灵活的条件系统：支持字符串、数字、日期、布尔值、数组、对象等多种数据类型
• 两种工作模式：Rules模式（可视化条件构建）和Expression模式（编程表达式）
• 智能降级处理：为不匹配任何条件的数据提供备选输出
• 高效的数据流：一条数据一旦匹配到某个输出，默认不会重复匹配其他规则

模式一：Rules模式（推荐初学者）

Rules模式是可视化条件构建方式，你无需编写任何代码，只需通过下拉菜单和输入框配置条件。

支持的数据类型和比较操作：

模式二：Expression模式（高级用户）

Expression模式使用JavaScript表达式来定义路由逻辑，适合需要复杂条件判断的高级场景。

例如：

第1步：添加Switch节点

1. 在工作流画布上点击”添加节点“（或按Tab键）
2. 搜索”Switch“
3. 选择Switch节点添加到工作流

第2步：配置路由规则

1. 打开Switch节点的配置面板
2. 确保”Mode“选择为”Rules“
3. 点击”Add Routing Rule“添加第一条规则
4. 根据你的数据，配置规则：
   • 左侧字段：选择你要检查的数据字段（例如 ）
   • 中间操作符：选择比较方式（例如 “等于”）
   • 右侧值：输入要比较的值（例如 “high”）

示例配置：

第3步：连接后续节点

1. Switch节点会自动为每条规则创建一个输出端口
2. 从这些输出端口拖拽连线到你的后续处理节点
3. 为每个输出分支配置不同的业务逻辑

1. 重命名输出（Rename Output）

默认情况下，Switch的输出被标记为”Output 0″、”Output 1″等数字标签。这容易混淆，特别是在复杂流程中。

最佳实践：启用”Rename Output“，给每条分支取个有意义的名字：

• ✅ 好：、、
• ❌ 差：、

配置步骤： 在配置规则时，勾选”Rename Output”，输入自定义名称。

2. 降级输出（Fallback Output）

当数据不匹配任何路由规则时，降级输出决定该数据的去向。

三种选项：

示例： 如果优先级字段出现意外值”urgent”，但你的规则中没有定义它，这条数据就会按照降级设置进行处理。

3. 忽略大小写（Ignore Case）

对于字符串比较，启用此选项后，、、会被视为相同。

建议：大多数场景下启用，避免因大小写不一致导致路由失败。

4. 严格类型验证（Less Strict Type Validation）

启用后，n8n会自动尝试类型转换。例如，字符串”123″可以与数字123比较。

默认建议：关闭。这样可以捕获潜在的数据类型错误。

5. 发送数据到所有匹配输出（Send data to all matching outputs）

默认行为：一条数据只要匹配到第一个规则，就停止检查其他规则。

启用后：同时匹配多个规则的数据会被复制到所有匹配的输出分支。

场景：标签系统中，一条数据可能同时属于多个标签，需要被发送到所有相关的处理流程。

实际建议：

• 问自己：”我需要2个还是更多个处理分支？”
• 如果≤2个，用If
• 如果>2个，用Switch

现在让我们用一个完整的、可执行的案例来演示Switch节点的强大功能。

业务场景

你的公司收到多渠道客户反馈，需要根据优先级进行分发：

• 高优先级（high）：立即通知管理员，通过紧急Slack频道
• 中优先级（medium）：记录到数据库，定期处理

n8n 工作流 教程

• 低优先级（low）：存档，月度回顾
• 未知优先级：人工审核队列

工作流架构

完整工作流JSON代码

如何使用这个工作流

第1步：导入工作流

1. 复制上述JSON代码
2. 进入你的n8n仪表板，点击”新建工作流”
3. 点击右上角”…”菜单，选择”从文件导入”
4. 粘贴JSON代码并导入

第2步：配置Webhook

1. 打开Webhook节点
2. 复制显示的Webhook URL
3. 使用任何HTTP工具（如Postman或curl）向该URL发送测试数据

第3步：发送测试数据

使用cURL命令：

第4步：检查执行结果

1. 运行工作流
2. 查看”执行历史”
3. 观察数据是否被正确路由到对应的优先级分支

❌ 错误1：数据没有被路由到任何输出

原因： 数据不匹配任何配置的规则

解决：

1. 检查字段名称是否正确（区分大小写）
2. 使用”执行单个节点”来查看前一个节点的实际输出
3. 检查比较值是否包含多余空格

❌ 错误2：大小写导致的匹配失败

原因： 数据中是”HIGH”，但规则中写的是”high”

解决：

1. 启用”Ignore Case“选项
2. 或在前一个节点中使用规范化数据

❌ 错误3：Expression模式返回NaN或undefined

原因： 表达式语法错误

解决：

1. 检查变量引用是否正确：
2. 使用JavaScript控制台测试表达式
3. 参考n8n表达式文档：docs.n8n.io/code-exampl…

❌ 错误4：多条规则都匹配，数据只输出到第一个

原因： 没有启用”Send data to all matching outputs”

解决：

1. 打开Switch节点的Options
2. 启用”Send data to all matching outputs“
3. 此时匹配多个规则的数据会被复制到所有对应的输出

技巧1：使用表达式实现复杂条件

在Rules模式下，虽然界面有限制，但你可以在比较值中使用表达式：

配置示例：

技巧2：根据数组长度进行路由

这样，只有标签数大于5的数据才会被路由到这条分支。

技巧3：使用正则表达式进行高级文本匹配

这样只会匹配特定邮箱域名的用户。

技巧4：先排序再Switch，优化性能

如果你的数据量很大，先用Sort节点对数据进行分组，再用Switch处理，能显著提升性能。

1. 单步执行

点击Switch节点，选择”Execute node“（执行此节点），只执行到这里停止，查看各分支的输出。

2. 使用日志节点（Logger Node）

在Switch前后各添加一个Logger节点，记录数据内容：

3. 检查表达式错误

在Expression模式下，若有错误，会显示红色警告。鼠标悬停可看错误详情。

4. 测试数据

使用”测试数据”功能注入虚拟数据：

掌握Switch节点后，你可以进一步学习：

1. 与If节点结合 – 构建更复杂的条件逻辑
2. Filter节点 – 过滤不需要的数据
3. Loop Over Items – 对集合中的每个元素运行Switch
4. 错误处理 – 使用Switch处理异常情况
5. 性能优化 – 在大数据量场景下优化Switch逻辑

官方文档

n8n系列教程