Skip to content

故障排除#

凭证问题#

错误消息：'Credentials of type "*" aren't known'#

检查凭证数组中的名称是否与凭证类属性名中使用的名称匹配。

凭证问题排查

编辑器界面问题#

错误消息：'There was a problem loading init data: API-Server can not be reached. It's probably down'#

  • 检查节点文件、节点文件夹和类的名称是否与添加到 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 用户在重命名文件时可能会遇到一个问题：即使你已经重命名了文件，linter 仍然会持续发出警告。这是由于 Windows 系统在重命名文件时更改大小写存在一个已知问题导致的。