故障排除#

凭据#

错误信息：'未知类型"*"的凭据'#

请检查凭据数组中的名称是否与凭据类属性名称中使用的名称匹配。 [凭据故障排除](https://docs.n8n.io/_images/integrations/creating-nodes/troubleshooting-credentials-1.png)

编辑器界面#

错误信息：'加载初始化数据时出现问题：无法连接到 API 服务器。可能已宕机'#

• 检查节点文件、节点文件夹和类的名称是否与添加到 packages/nodes-base/package.json 中的路径匹配。
• 检查 displayOptions 属性中使用的名称是否为节点中 UI 元素使用的名称。

节点图标未显示在添加节点菜单和编辑器界面中#

• 检查图标是否与节点位于同一文件夹中。
• 检查图标是否为 PNG 或 SVG 格式。
• 当 icon 属性引用图标文件时，请检查是否包含文件扩展名（.png 或 .svg）并确保前缀为 file:。例如：file:friendGrid.png 或 file:friendGrid.svg。

节点图标尺寸不合适#

• 如果使用 SVG 文件，请确保画布尺寸为正方形。您可以在此处找到使用 GIMP 更改 SVG 文件画布尺寸的说明。
• 如果使用 PNG 文件，请确保其尺寸为 60x60 像素。

节点未出现在添加节点菜单中#

请检查是否已在项目的 package.json 文件中注册该节点。

描述属性修改后刷新界面未生效#

每次修改描述属性后，都需要停止当前 n8n 进程（使用 ctrl + c 组合键）并重新运行。您可能还需要重新执行 npm link 命令。

Linter 错误警告文件名大小写问题#

节点检查器 (linter) 对文件名有规则要求，包括大小写规范。Windows 用户在重命名文件时可能会遇到一个问题：即使已完成文件重命名，检查器仍持续发出警告。这是由于 Windows 系统在重命名文件时更改大小写存在的已知问题导致的。