跳至内容

故障排除与错误处理#

错误:缺少依赖包#

n8n 将社区节点直接安装到硬盘上。这些文件必须在启动时可用,以便n8n加载它们。如果启动时找不到这些包,你会收到关于缺失包的错误警告。

如果使用Docker运行n8n:根据您的Docker设置,在重新创建容器或升级n8n版本时可能会丢失软件包。您必须:

  • 持久化保存~/.n8n/nodes目录内容。这是最佳选择。如果按照Docker安装指南操作,设置步骤中已包含对该目录的持久化配置。
  • 将环境变量 N8N_REINSTALL_MISSING_PACKAGES 设置为 true

第二种选项可能会增加启动时间,并可能导致健康检查失败。

防止在n8n云上加载社区节点#

如果您的n8n云实例崩溃且无法启动,可以阻止在实例启动时加载已安装的社区节点。请访问Cloud Admin Panel > 管理,并将禁用所有社区节点切换为true。此切换选项仅在您允许安装社区节点时可见。

优云智算