Skip to content

故障排除#

¥Troubleshooting

凭据#

¥Credentials

错误消息：'类型为 "*" 的凭据无效。已知'#

¥Error message: 'Credentials of type "*" aren't known'

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

¥Check that the name in the credentials array matches the name used in the property name of the credentials' class.

Troubleshooting credentials

编辑器界面#

¥Editor UI

错误消息：初始化数据加载出现问题：无法连接到 API 服务器。可能已关闭#

¥Error message: 'There was a problem loading init data: API-Server can not be reached. It's probably down'

  • 检查节点文件、节点文件夹和类的名称是否与添加到 packages/nodes-base/package.json 的路径匹配。

¥Check that the names of the node file, node folder, and class match the path added to packages/nodes-base/package.json.

  • 检查 displayOptions 属性中使用的名称是否与节点中 UI 元素使用的名称一致。

¥Check that the names used in the displayOptions property are names used by UI elements in the node.

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

¥Node icon doesn't show up in the Add Node menu and the Editor UI

  • 检查图标是否与节点位于同一文件夹中。

¥Check that the icon is in the same folder as the node.

  • 检查其格式是否为 PNG 或 SVG。

¥Check that it's either in PNG or SVG format.

  • 当 icon 属性引用图标文件时，请检查它是否包含徽标扩展名（.png 或 .svg）以及是否以 file: 为前缀。例如，file:friendGrid.png 或 file:friendGrid.svg。

¥When the icon property references the icon file, check that it includes the logo extension (.png or .svg) and that it prefixes it with file:. For example, file:friendGrid.png or file:friendGrid.svg.

节点图标显示不全#

¥Node icon doesn't fit

  • 如果你使用 SVG 文件，请确保画布大小为正方形。你可以在 此处 中找到有关如何使用 GIMP 更改 SVG 文件画布大小的说明。

¥If you use an SVG file, make sure the canvas size is square. You can find instructions to change the canvas size of an SVG file using GIMP here.

  • 如果你使用 PNG 文件，请确保其尺寸为 60x60 像素。

¥If you use a PNG file, make sure that it's 60x60 pixels.

节点未显示在“添加节点”菜单中#

¥Node doesn't show up in the Add Node menu

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

¥Check that you registered the node in the package.json file in your project.

刷新后，描述属性的更改未显示在 UI 中#

¥Changes to the description properties don't show in the UI on refreshing

每次更改描述属性时，都必须停止当前的 n8n 进程 (ctrl + c) 并重新运行。你可能还需要重新运行 npm link。

¥Every time you change the description properties, you have to stop the current n8n process (ctrl + c) and run it again. You may also need to re-run npm link.

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

¥Linter incorrectly warning about file name case

该节点的代码检查器对文件名有规则，包括文件名的大小写。Windows 用户在重命名文件时可能会遇到问题，即使重命名文件后，代码检查器仍会继续发出警告。这是由于重命名文件时 已知 Windows 问题 的大小写发生变化造成的。

¥The node linter has rules for file names, including what case they should be. Windows users may encounter an issue when renaming files that causes the linter to continue giving warnings, even after you rename the files. This is due to a known Windows issue with changing case when renaming files.