ERR_BUFFER_TOO_LARGE

이 오류가 뜻하는 것

허용된 최대 크기보다 큰 Buffer를 만들려고 했음을 나타냅니다.

이 문서는 화면이나 로그의 원문을 식별하고 다음 확인 순서를 제시합니다. 오류 문구만으로 운영 환경의 단일 원인을 확정하지 않습니다.

확인 절차

1. 오류 객체의 error.code 값이 ERR_BUFFER_TOO_LARGE인지 확인합니다.
2. 오류가 발생한 Node.js 버전과 실행 명령을 같은 환경에서 기록합니다.
3. 스택 트레이스의 첫 번째 애플리케이션 코드와 입력값을 확인합니다.

해결 순서

1. 오류 코드와 입력값을 보존한 상태에서 최소 재현 명령을 실행합니다.
2. Node.js 버전과 package manager lockfile을 고정하고 다시 실행합니다.
3. 권한·파일·네트워크 변경이 필요한 경우 먼저 실패한 syscall과 대상 경로를 확인한 뒤 최소 범위만 수정합니다.

주의

• 운영 중인 데이터, 권한, 포트, 인증서와 배포 대상을 한 번에 변경하지 않습니다.
• 수정 전 오류 원문, 실행 명령, 로그 시각과 관련 버전을 보관합니다.
• 공식 문서가 설명하지 않는 환경별 원인은 재현 결과와 해당 플랫폼 문서를 추가로 확인합니다.

공식 근거

• Errors | Node.js Documentation (새 창에서 열림)