问题复现：Filter节点到底在“卡”什么？

在N8N大学的社群里，我见过太多新手被 Filter 节点“劝退”。明明逻辑很简单——“如果A等于B就继续，否则就停止”，但工作流跑起来却莫名其妙地中断，或者干脆把所有数据都放行了。

最典型的报错场景通常长这样：节点显示红框，提示 Execution stopped 或者 No data to process。有时候数据明明过去了，但下游节点却报数据格式不对，一查源头，又是 Filter 没处理好。

笔者作为N8N大学的主编，摸爬滚打8年，深知这种“卡壳”往往不是n8N本身的问题，而是我们对数据流和逻辑判断的理解出现了偏差。别急，今天就带你像老司机一样，把Filter节点的常见坑一个个填平。

原因分析：为什么Filter节点总是“闹脾气”？

用大白话说，Filter节点就是流水线上的“质检员”。它手里拿着一张清单（你的规则），过一件产品（数据），查一件。如果查不过，它就把产品扔进废料桶（停止执行），或者只是简单地放行（不执行后续逻辑）。

它“闹脾气”的核心原因通常有三个：

• 逻辑太绕： 把“与”和“或”搞混了，导致判断条件永远为假或永远为真。
• 数据类型不对： 你拿字符串去和数字比大小，或者想从JSON里取值却写错了路径。
• 对“空值”的误解： 不知道 n8n 如何处理 null 或 undefined，导致流程意外中断。

解决方案：三步搞定Filter节点排查

第一步：学会看“Preview”（预览）

这是最简单却最容易被忽略的一步。当你在 Filter 节点里设置好规则后，点击节点，右侧会有一个 “Preview” 按钮（或者叫“测试”）。

老司机经验： 不要凭感觉写逻辑！先在预览里选一条真实的数据，看看你的规则到底返回了 True 还是 False。如果预览结果和你预期的相反，那说明你的逻辑写反了。

比如，你想筛选“状态”为“active”的用户。如果预览里明明数据是 active，却显示 False，检查一下是不是手误写成了 != active，或者把字符串写成了带引号的 "active"（n8n有时会自动处理，有时不会，看表达式写法）。

第二步：搞懂“与”和“或”的优先级

n8n的 Filter 节点在“简单模式”下，通常是“与”关系（AND）。但在“复杂模式”（使用表达式）下，逻辑全靠你自己写 JavaScript。

很多坑就出在这里。比如你想写：
状态 == 'active' 且 (角色 == 'admin' 或 角色 == 'editor')

如果你在简单模式里直接堆砌条件，n8n可能会理解为：状态是active 且 角色是admin 且 角色是editor（这显然永远为假）。

解决方案： 当逻辑超过两个层级，请果断切换到 Expression（表达式） 模式，手动编写 JavaScript 逻辑：

// 这里的 $json 代表当前的输入数据
return $json.status === 'active' && ($json.role === 'admin' || $json.role === 'editor');

这样写，逻辑清晰，且不容易出错。

第三步：处理“空值”与数据类型

这是新手最容易遇到的“数据丢失”陷阱。假设你的数据里，某个字段可能不存在。

// 输入数据：{ "name": "Tom", "age": null }

如果你在 Filter 写了 age > 18，在 JavaScript 里，null > 18 的结果是 False。这没问题。但如果数据里压根没有 age 这个字段，age > 18 会报错吗？不会，它会返回 False。

但如果你写的是 age != null，且数据里没有 age 字段，这个表达式的行为在不同版本的 n8n 中可能略有差异。为了保险起见，N8N大学建议在表达式里使用 safeJsonParse 或者直接判断字段是否存在：

// 推荐写法：先判断是否存在，再判断值
return $json.age !== undefined && $json.age !== null && $json.age > 18;

预防措施：养成良好的调试习惯

为了避免以后再次被 Filter 节点卡住，笔者建议你养成两个习惯：

1. 善用“Set”节点做标记： 在复杂的逻辑判断前，插入一个 Set 节点，手动给数据加一个字段，比如 debug_flag: true。这样在后续节点出错时，你能立刻知道数据是经过了哪条路径。

2. 分段测试： 不要把所有逻辑都塞进一个 Filter 节点。如果逻辑特别复杂，拆分成两个或多个 Filter 节点串联。虽然看起来节点多了，但排查问题时会轻松十倍。

FAQ 问答

Q1: Filter节点报错“Cannot read property of undefined”怎么办？

这通常是因为你引用了不存在的字段。比如写 $json.user.name，但数据里 user 是 null 或者根本不存在。请使用可选链操作符：$json?.user?.name，或者在表达式里先做防御性判断。

Q2: 为什么我的 Filter 节点没有任何输出（数据全没了）？

检查你的条件是否过于严格。建议先将条件改为 1 == 1（永远为真），看数据是否能通过。如果能通过，再逐步收紧条件，直到找到导致失败的那个具体条件。

Q3: Filter节点能处理数组吗？

默认情况下，Filter 节点是针对单条数据项（Item）进行处理的。如果你的上游节点输出的是一个包含多个对象的数组，n8n 通常会将其拆分为多个 Item。如果你需要对整个数组进行过滤（比如“数组长度大于5”），你需要确保上游节点的配置正确，或者在 Filter 表达式中处理聚合逻辑。

总结与资源

Filter 节点是 n8n 中最基础也最强大的逻辑控制枢纽。它报错，90% 的情况不是节点坏了，而是你的逻辑条件写得不严谨，或者对数据结构的预判有误。

记住 N8N大学 的口诀：先预览，再写逻辑；多用表达式，少用简单模式；遇到空值要防御。

如果你在使用过程中遇到了更诡异的 Filter 报错，欢迎在 N8N大学 (n8ndx.com) 的社区留言，我们下期再会！