문제 해결
n8n v2.42요약
credentials 배열에 있는 이름이 자격 증명 클래스의 속성 이름에서 사용된 이름과 일치하는지 확인하세요. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 노드의 credentials 배열은 동일한 name 값을 참조해야 합니다.
자격 증명#
오류 메시지: 'Credentials of type "*" aren't known'#
credentials 배열에 있는 이름이 자격 증명 클래스의 속성 이름에서 사용된 이름과 일치하는지 확인하세요. 예를 들어 다음 자격 증명 클래스는 name을 friendGridApi로 설정합니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
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#
오류 메시지: 'There was a problem loading init data: API-Server can not be reached. It's probably down'#
- 노드 파일, 노드 폴더, 클래스의 이름이
packages/nodes-base/package.json에 추가된 경로와 일치하는지 확인하세요. displayOptions속성에서 사용된 이름이 노드의 UI 요소에서 사용되는 이름과 일치하는지 확인하세요.
Add Node 메뉴와 에디터 UI에 노드 아이콘이 표시되지 않음#
- 아이콘이 노드와 같은 폴더에 있는지 확인하세요.
- PNG 또는 SVG 형식인지 확인하세요.
icon속성이 아이콘 파일을 참조할 때, 로고 확장자(.png또는.svg)를 포함하고 앞에file:을 붙였는지 확인하세요. 예를 들어file:friendGrid.png또는file:friendGrid.svg와 같이 작성합니다.
노드 아이콘이 맞지 않음#
- SVG 파일을 사용하는 경우, 캔버스 크기가 정사각형인지 확인하세요. SVG 파일의 캔버스 크기를 변경하는 방법은 GIMP의 캔버스 크기 조정 가이드를 참고하세요.
- PNG 파일을 사용하는 경우, 크기가 60x60 픽셀인지 확인하세요.
Add Node 메뉴에 노드가 표시되지 않음#
프로젝트의 package.json 파일에 노드를 등록했는지 확인하세요.
description 속성을 변경해도 새로고침 시 UI에 반영되지 않음#
description 속성을 변경할 때마다 현재 실행 중인 n8n-node dev 프로세스를 중지(ctrl + c)한 후 다시 실행해야 합니다.
린터가 파일 이름 대소문자에 대해 잘못된 경고를 표시함#
노드 린터에는 파일 이름에 대한 규칙이 있으며, 여기에는 대소문자를 어떻게 사용해야 하는지도 포함됩니다. Windows 사용자는 파일 이름을 변경할 때 파일 이름을 변경한 후에도 린터가 계속 경고를 표시하는 문제를 겪을 수 있습니다. 이는 파일 이름 변경 시 대소문자를 변경하는 것과 관련된 알려진 Windows 문제 때문입니다.