内存相关错误
n8n 不限制每个节点可以获取和处理的数据量。虽然这为您提供了自由,但当工作流执行需要的内存超过可用内存时,可能会导致错误。本页解释了如何识别和避免这些错误。
提示
Only for self-hosted n8n 仅适用于自托管 n8n
本页描述了 自托管 n8n 时与内存相关的错误。访问云数据管理了解n8n Cloud的内存限制。
识别内存不足的情况
n8n 提供错误消息,在某些内存不足情况下警告您。例如,诸如 执行在此节点停止(n8n 在执行时可能内存不足) 的消息。
包含 运行工作流时出现问题、连接丢失 或 503 服务暂时不可用 的错误消息表明 n8n 实例已变得不可用。
在自托管 n8n 时,您还可能在服务器日志中看到诸如 分配失败 - JavaScript 堆内存不足 的错误消息。
在 n8n Cloud 上,或使用 n8n 的 Docker 镜像时,n8n 在遇到此类问题时会自动重启。但是,使用 npm 运行 n8n 时,您可能需要手动重启它。
典型原因
当工作流执行需要的内存超过 n8n 实例可用内存时,会出现此类问题。增加工作流执行内存使用量的因素包括:
- JSON 数据 的数量。
- 二进制数据的大小。
- 工作流中的节点数。
- 某些节点占用大量内存:代码 节点和较旧的 Function 节点会显着增加内存消耗。
- 手动或自动工作流程执行:手动执行会增加内存消耗,因为 n8n 会为前端复制数据。
- 同时运行其他工作流程。
避免内存不足的情况
遇到内存不足情况时,有两个选择:要么增加 n8n 可用的内存量,要么减少内存消耗。
增加可用内存
在自托管 n8n 时,增加 n8n 可用的内存量意味着为您的 n8n 实例提供更多内存。这可能会产生托管提供商的额外费用。
在 n8n cloud 上,您需要升级到更大的计划。
减少内存消耗
这种方法更复杂,意味着重新构建导致问题的工作流。本节提供一些关于如何减少内存消耗的指导。并非所有建议都适用于所有工作流。
- 将处理后的数据分割成更小的块。例如,每次执行处理 200 行,而不是每次执行获取 10,000 行。
- 尽可能避免使用代码节点。
- 处理大量数据时避免手动执行。
- 将工作流程拆分为子工作流程,并确保每个子工作流程向其父工作流程返回有限数量的数据。
拆分工作流一开始可能看起来有悖常理,因为它通常需要添加至少两个节点:循环项目 节点,用于将项目拆分为更小的批次;执行工作流 节点,用于启动子工作流。
但是,只要您的子工作流为每个批次执行繁重的工作,然后只向主工作流返回一小部分结果集,这就会减少内存消耗。这是因为子工作流只在内存中保存当前批次的数据,之后内存再次释放。
增加旧内存
这适用于自托管 n8n。遇到 JavaScript 堆内存不足 错误时,为 V8 JavaScript 引擎的旧内存部分分配额外内存通常很有用。为此,通过 CLI 或通过 NODE_OPTIONS 环境变量{:target=_blank .external-link}设置适当的 V8 选项{:target=_blank .external-link} --max-old-space-size=SIZE。