故障排除与错误处理#
错误：缺少依赖包#
n8n 会直接将社区节点模块安装到硬盘上。启动时这些文件必须可用，n8n 才能加载它们。如果启动时缺少这些包，系统会提示缺少依赖包的错误。
如果使用 Docker 运行 n8n：根据您的 Docker 配置，在重建容器或升级 n8n 版本时可能会丢失这些包。您必须采取以下措施之一：
- 持久化
~/.n8n/nodes目录内容。这是最佳解决方案。如果您遵循 Docker 安装指南，配置步骤中已包含对该目录的持久化设置。 - 将
N8N_REINSTALL_MISSALL_PACKAGES环境变量设为true。
第二种方案可能会增加启动时间，并可能导致健康检查失败。
在 n8n 云上禁用社区节点加载#
如果您的 n8n 云实例崩溃且无法启动，可以阻止已安装的社区节点在实例启动时加载。访问 云管理面板 > 管理，将禁用所有社区节点切换为 true。此选项仅在您允许安装社区节点时可见。