故障排除和错误(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 安装 指南操作,设置步骤包括保留这个目录。 - 将
N8N_REINSTALL_MISSING_PACKAGES环境变量设置为true。
第二个选项可能会增加启动时间,并可能导致运行状况检查失败。工作流的第二部分包含四个节点:
🌐 The second option might increase startup time and may cause health checks to fail.
防止在 n8n 上加载社区节点云(Prevent loading community nodes on n8n cloud)#
如果你的 n8n 云实例崩溃并且无法启动,你可以阻止已安装的社区节点在实例启动时加载。访问 Cloud Admin Panel > 管理,然后将 禁用所有社区节点 切换为 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.