故障排除与错误#

错误：缺少软件包#

n8n 将社区节点直接安装到硬盘。启动时这些文件必须可用，n8n 才能加载它们。如果启动时软件包不可用，您将收到缺少软件包的错误警告。

若使用 Docker 运行 n8n：根据您的 Docker 配置，在重新创建容器或升级 n8n 版本时可能会丢失软件包。您必须执行以下操作之一：

• 持久化 ~/.n8n/nodes 目录的内容。这是最佳选项。如果遵循 Docker 安装指南，设置步骤已包含该目录的持久化配置。
• 将 N8N_REINSTALL_MISSING_PACKAGES 环境变量设置为 true。

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

在 n8n 云平台阻止加载社区节点#

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