ERR_OUT_OF_RANGE
빠른 답변
- 이 오류는 무엇인가요?
- Node.js에서 값이 허용 범위를 벗어났음을 나타내는 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- ERR_OUT_OF_RANGE는 전달된 값이 허용 범위를 벗어났음을 나타냅니다.
- 무엇을 먼저 확인해야 하나요?
- 오류 객체의 error.code가 ERR_OUT_OF_RANGE와 정확히 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체의 error.code가 ERR_OUT_OF_RANGE와 정확히 일치하는지 확인합니다.
일치하면 전달된 값이 허용 범위를 벗어났다는 의미로 판정합니다.
환경별 원인과 조치
확인
오류 객체의 error.code 값을 확인합니다.
- 값이
ERR_OUT_OF_RANGE이면 Node.js가 전달된 값이 허용 범위를 벗어났다고 식별한 것입니다. - 값이 다르면 이 문서의 오류 코드에 해당하지 않습니다.
Node.js는 오류 메시지가 버전 사이에 변경될 수 있으므로 error.code로 오류를 식별하도록 안내합니다.
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js의 ERR_OUT_OF_RANGE는 전달된 값이 허용 범위를 벗어났음을 나타냅니다., Node.js 오류는 error.message 대신 error.code로 식별하는 방법이 더 안정적입니다. · 확인일: 2026-07-24