故障排除
凭证
错误消息:“类型“*”的凭据未知”
检查凭据数组中的名称是否与凭据类的 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,
},
],

编辑器 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 工作流库 找现成的中文工作流。