n8n 中文文档

故障排除

凭证

错误消息:“类型“*”的凭据未知”

检查凭据数组中的名称是否与凭据类的 name 属性值一致。例如,以下凭据类将 name 设为 friendGridApi:

export class FriendGridApi implements ICredentialType {
    name = 'friendGridApi';
    displayName = 'FriendGrid API';
    documentationUrl = 'friendGrid';
    properties = [
        {
            displayName: 'API Key',
            name: 'apiKey',
            type: 'string' as NodePropertyTypes,
            default: '',
        },
    ];
}

节点的 credentials 数组必须引用相同的 name 值:

credentials: [
    {
        name: 'friendGridApi',
        required: true,
    },
],

代码示例,其中箭头将凭据类的 name 属性指向节点 credentials 数组中与之匹配的 name 字段

编辑器 UI

错误消息:“加载初始化数据时出现问题:无法访问 API 服务器。 It's probably down'

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

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

  • 检查图标是否与节点在同一文件夹中。
  • 检查它是否为 PNG 或 SVG 格式。
  • 当 icon 属性引用图标文件时,检查它是否包含徽标扩展名(.png 或 .svg)并且以 file: 为前缀。例如,file:friendGrid.png 或 file:friendGrid.svg。

Node icon doesn't fit

  • 如果您使用 SVG 文件,请确保画布大小为正方形。您可以在GIMP 调整画布大小指南找到使用 GIMP 更改 SVG 文件画布大小的说明。
  • 如果您使用 PNG 文件,请确保它是 60x60 像素。

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

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

刷新 时,对描述属性的更改不会显示在 UI 中

每次更改描述属性时,都必须停止当前的 n8n-node dev 进程(ctrl + c),然后重新运行。

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

节点检查器有文件名规则,包括它们应该使用什么大小写。Windows 用户在重命名文件时可能会遇到问题,导致检查器继续发出警告,即使在重命名文件后也是如此。这是由于重命名文件时更改大小写的已知 Windows 问题。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。