n8n은 각 노드가 가져오고 처리할 수 있는 데이터 양을 제한하지 않습니다. 이는 자유로움을 제공하지만, 워크플로 실행에 사용 가능한 메모리보다 더 많은 메모리가 필요한 경우 오류가 발생할 수 있습니다. 이 페이지에서는 이러한 오류를 식별하고 방지하는 방법을 설명합니다.

메모리 부족 상황 식별하기#

n8n은 일부 메모리 부족 상황에서 경고하는 오류 메시지를 제공합니다. 예를 들어 **Execution stopped at this node (n8n may have run out of memory while executing it)**와 같은 메시지가 있습니다.

Problem running workflow, Connection Lost, 또는 503 Service Temporarily Unavailable과 같은 오류 메시지는 n8n 인스턴스를 사용할 수 없게 되었음을 나타냅니다.

n8n을 셀프 호스팅하는 경우 서버 로그에서 Allocation failed - JavaScript heap out of memory와 같은 오류 메시지가 표시될 수도 있습니다.

n8n Cloud에서나 n8n의 Docker 이미지를 사용하는 경우, 이러한 문제가 발생하면 n8n이 자동으로 재시작됩니다. 하지만 npm으로 n8n을 실행하는 경우에는 수동으로 재시작해야 할 수도 있습니다.

일반적인 원인#

이러한 문제는 워크플로 실행에 n8n 인스턴스에서 사용 가능한 메모리보다 더 많은 메모리가 필요할 때 발생합니다. 워크플로 실행의 메모리 사용량을 증가시키는 요인은 다음과 같습니다.

• JSON 데이터의 양
• 바이너리 데이터의 크기
• 워크플로 내 노드 수
• 일부 노드는 메모리를 많이 사용합니다. Code 노드와 이전 버전의 Function 노드는 메모리 소비를 크게 늘릴 수 있습니다.
• 수동 또는 자동 워크플로 실행: 수동 실행 시 n8n이 프런트엔드용으로 데이터를 복사하므로 메모리 소비가 증가합니다.
• 동시에 실행되는 추가 워크플로

메모리 부족 상황 방지하기#

메모리 부족 상황이 발생하면 두 가지 방법이 있습니다. n8n에서 사용 가능한 메모리 양을 늘리거나 메모리 소비를 줄이는 것입니다.

사용 가능한 메모리 늘리기#

n8n을 셀프 호스팅하는 경우, n8n에서 사용 가능한 메모리 양을 늘리려면 n8n 인스턴스에 더 많은 메모리를 프로비저닝해야 합니다. 이로 인해 호스팅 제공업체에 추가 비용이 발생할 수 있습니다.

n8n Cloud에서는 더 큰 플랜으로 업그레이드해야 합니다.

메모리 소비 줄이기#

이 방법은 더 복잡하며 문제를 일으키는 워크플로를 다시 빌드해야 함을 의미합니다. 이 섹션에서는 메모리 소비를 줄이는 방법에 대한 몇 가지 가이드라인을 제공합니다. 모든 제안이 모든 워크플로에 적용되는 것은 아닙니다.

이전 메모리 영역 늘리기#

이는 셀프 호스팅 n8n에 적용됩니다. JavaScript heap out of memory 오류가 발생하면 V8 JavaScript 엔진의 이전 메모리(old memory) 영역에 추가 메모리를 할당하는 것이 유용한 경우가 많습니다. 이를 위해 CLI 또는 NODE_OPTIONS 환경 변수를 통해 적절한 V8 옵션 --max-old-space-size=SIZE를 설정하세요.