脏节点#

一个 脏节点（dirty node） 是指过去曾成功执行过，但 n8n 当前认为其输出已过时或不可靠的节点。标记为脏节点意味着如果该节点再次执行，其输出可能会发生变化。这也可能是 部分执行（partial execution） 开始的位置。

如何识别脏节点数据#

在工作流编辑器的画布中，你可以通过不同颜色的边框以及原本绿色对勾符号位置上的黄色三角形来识别脏节点。例如：

"显示带有黄色边框的节点图像"

在节点编辑器视图中，输出面板也会在相应位置显示一个黄色三角形。将鼠标悬停在三角形上时，会弹出一个工具提示，说明 n8n 为何认为该数据已过时：

"显示带有黄色边框的节点图像"

为什么 n8n 会将节点标记为脏节点#

n8n 可能将执行数据标记为过时的原因有多种，例如：

• 插入或删除节点：将紧随插入节点之后的第一个节点标记为脏节点。
• 修改节点参数：将被修改的节点标记为脏节点。
• 添加连接线（connector）：将新连接线的目标节点标记为脏节点。
• 停用节点：将紧随被停用节点之后的第一个节点标记为脏节点。

其他导致 n8n 标记脏节点的情况包括：

• 取消固定（unpinning）节点：将取消固定的节点标记为脏节点。
• 修改已固定的（pinned）数据：将位于已固定数据之后的节点标记为脏节点。
• 如果上述任一操作发生在循环内部，则还会将循环的第一个节点标记为脏节点。

对于子节点（sub-nodes），在发生以下任一操作时，也会将所有已执行的父节点（直至根节点）标记为脏节点：

• 编辑已执行的子节点

• 添加新的子节点

• 断开或删除子节点

• 停用子节点

• 启用子节点

• 当删除工作流中已连接的节点时： "显示带有黄色边框的节点图像"

• 序列中的下一个节点变为脏节点： "显示带有黄色边框的节点图像"

当使用循环（通过 Loop over Items 节点）时，如果循环内的任意节点处于“脏”状态（dirty），则该循环的初始节点也会被视为“脏”状态：

"显示为黄色边框的节点示意图"

解决脏节点问题#

重新执行一个节点会清除其“脏”状态。你可以通过以下方式手动操作：触发整个工作流，或对单个节点或其后续的任意节点使用 Execute step 功能进行 部分执行。