问题复现：If 节点的“静默失败”最让人抓狂
在 N8N 大学的后台私信里，关于 If 节点的报错问题，最近几乎霸占了榜单。
你是不是也遇到过这种情况？工作流明明跑通了，但数据流就是没走到你预设的分支里；或者更糟糕，If 节点直接报红，提示“Execution data missing”或“Expression evaluation error”，但你盯着条件看了半天，逻辑明明是对的。
这种“静默失败”最让人抓狂。它不像网络错误那样直接，而是藏在逻辑判断的缝隙里，让你怀疑人生。笔者在调试一个复杂的电商库存同步流程时，就曾被一个简单的 If 节点卡住整整一下午。最后发现，问题根本不在逻辑本身，而在数据的“伪装”上。
今天，笔者就把 N8N 大学内部总结的三种调试思路抖出来，专治各种 If 节点不服。
原因分析：为什么你的条件判断总是“翻车”？
在 n8n 中，If 节点的工作原理其实很简单：它接收上流数据，根据你写的表达式（Expression）返回 true 或 false，然后决定走哪条路。
但魔鬼藏在细节里，报错通常源于以下三个核心原因：
- 数据类型错位：你以为你在比较数字（如
10），实际上接收到的是字符串（如"10"），导致逻辑判断失效。 - 路径（Path）错误：n8n 的数据是 JSON 格式的，如果你在表达式里选错了数据路径，节点就找不到变量，自然报错。
- 空值（Null）陷阱：当上游数据为空，表达式试图对
null进行操作时，n8n 会直接抛出异常，阻断流程。
解决方案：三种硬核调试思路
别急着重写工作流，先按顺序尝试以下三种方法。它们分别对应“肉眼排查”、“数据透视”和“暴力拆解”。
思路一：开启“显示完整表达式”，肉眼排雷
n8n 的动态输入框虽然好用，但有时会隐藏参数的真实值。这是最简单的第一步。
操作步骤：
- 双击打开你的
If节点。 - 点击节点右上角的“设置”图标（齿轮状）。
- 在弹出的菜单中，找到并开启“Show full JSON” 或 “显示完整 JSON”（取决于你的版本）。
- 此时，你会看到输入数据的完整结构。仔细核对你的条件表达式引用的路径（例如
{{ $json.user_id }}）是否真的存在。
避坑点： 注意观察路径前的图标。如果是灰色的，说明该路径在当前批次的数据中不存在，这就是报错的元凶。
思路二：利用 Debug 节点，透视数据真相
如果肉眼看着没问题，但逻辑还是走不对，那说明数据在“撒谎”。我们需要一个“显微镜”——Debug 节点。
操作步骤：
- 在
If节点之前，拖入一个Set节点（或者 n8n 1.0+ 版本的Debug节点）。 - 在
Set节点中，新增一个字段，Key 随便填（如debug_data），Value 填{{ $json }}。这会把整个输入数据原样打印出来。 - 运行工作流，双击这个 Debug 节点，查看 “Output” 标签页。
- 重点检查： 你的目标字段是数字还是字符串？是
100还是"100"？是true还是"true"？
实战技巧： 很多时候 API 返回的数字是字符串格式。在 If 节点做比较时，记得使用 parseInt() 或 parseFloat() 强制转换，或者在条件里给字符串加引号（如比较 {{ $json.status }} == "1"）。
思路三：简化逻辑，分步验证（暴力拆解法）
如果你的 If 节点里写了一个超长的嵌套表达式（比如 {{ $json.a > 1 && ($json.b == 'c' || $json.d != null) }}），一旦报错，你根本不知道是哪一段出了问题。
操作步骤：
- 将复杂的
If节点复制一份，或者新建一个If节点放在原节点后面。 - 把原节点的条件拆解。例如，先只判断
{{ $json.a > 1 }}。 - 如果通过，再判断下一段。或者，使用
Set节点提前计算好所有中间变量。 - 利用 n8n 的“强制执行”功能： 鼠标右键点击节点，选择“Execute Node”。这样可以只运行到当前节点，不用从头跑，极大提高调试效率。
这种方法虽然看起来笨，但它是解决复杂逻辑报错最稳健的方式。它能让你精准定位到是哪一行表达式引发了错误。
预防措施：建立防错机制
解决了当下的问题，我们还得防止它再次发生。在 n8n 大学的实战指南中，我们强烈建议养成以下习惯：
- 使用默认值： 在表达式中使用
{{ $json.field || 'default' }}这种写法，防止字段缺失导致报错。 - 善用 Filter 节点： 不要把所有逻辑都塞进
If节点。对于数据清洗和初步筛选，Filter节点往往比If更稳定、更直观。 - 开启错误处理： 在
If节点的配置中，留意是否有“Error Handling”选项，或者在下游连接一个Error Trigger节点，确保即使逻辑报错也能捕获并记录。
FAQ 问答
Q1: If 节点提示 “Cannot read property of undefined” 怎么办？
A：这通常是因为你引用的 JSON 路径不存在。请检查你的数据结构，确保路径层级正确。如果不确定，使用思路二中的 Debug 节点查看完整 JSON。
Q2: 如何在 If 节点中判断多个条件（AND/OR）？
A：在 n8n 的 If 节点中，你可以添加多个条件行。默认情况下，不同行之间是“AND”关系。如果需要“OR”关系，通常需要在表达式里手动写逻辑（如 {{ cond1 || cond2 }}），或者使用两个 If 节点串联。
Q3: If 节点的条件表达式支持正则吗？
A：支持。n8n 基于 JavaScript，你可以在表达式中使用 .test() 方法。例如：{{ /your_regex/.test($json.field) }}。
总结与资源
调试 n8n 的 If 节点，本质上是一场与数据格式的博弈。90% 的报错都源于数据类型不匹配或路径错误。记住 N8N 大学的口诀：先看结构，再看类型，最后拆逻辑。
如果你在调试过程中遇到了更奇葩的报错，欢迎在 N8N 大学（n8ndx.com）的社区版块发帖，笔者会亲自为你解答。别让一个小节点卡住你自动化的脚步。
