Skip to content

故障排除和错误#

¥Troubleshooting and errors

错误：缺失的软件包#

¥Error: Missing packages

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

¥n8n installs community nodes directly onto the hard disk. The files must be available at startup for n8n to load them. If the packages aren't available at startup, you get an error warning of missing packages.

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

¥If running n8n using Docker: depending on your Docker setup, you may lose the packages when you recreate your container or upgrade your n8n version. You must either:

  • 持久化 ~/.n8n/nodes 目录的内容。这是最佳选择。如果你按照 Docker 安装 指南操作，设置步骤包括持久化此目录。

¥Persist the contents of the ~/.n8n/nodes directory. This is the best option. If you follow the Docker installation guide, the setup steps include persisting this directory.

  • 将 N8N_REINSTALL_MISSING_PACKAGES 环境变量设置为 true。

¥Set the N8N_REINSTALL_MISSING_PACKAGES environment variable to true.

第二个选项可能会增加启动时间，并可能导致运行状况检查失败。工作流的第二部分包含四个节点：

¥The second option might increase startup time and may cause health checks to fail.

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

¥Prevent loading community nodes on n8n cloud

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

¥If your n8n cloud instance crashes and fails to start, you can prevent installed community nodes from loading on instance startup. Visit the Cloud Admin Panel > Manage and toggle Disable all community nodes to true. This toggle is only visible when you allow community node installation.