ERR_MODULE_NOT_FOUND
빠른 답변
- 이 오류는 무엇인가요?
- Node.js에서 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 나타내는 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- ERR_MODULE_NOT_FOUND는 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점을 로드하는 중 모듈 파일을 해석하지 못했음을 나타냅니다.
- 무엇을 먼저 확인해야 하나요?
- 오류 객체 또는 로그의 error.code가 ERR_MODULE_NOT_FOUND와 정확히 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체 또는 로그의 error.code가 ERR_MODULE_NOT_FOUND와 정확히 일치하는지 확인합니다.
오류가 import 작업 또는 프로그램 진입점 로드 중 발생했는지 확인합니다.
환경별 원인과 조치
확인
- 오류 객체 또는 로그에서
error.code값을 확인합니다. - 값이
ERR_MODULE_NOT_FOUND와 일치하는지 비교합니다. - 일치하면 Node.js 공식 문서상 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점을 로드하는 중 모듈 파일을 해석하지 못한 경우입니다.
Node.js는 오류 메시지가 버전 사이에 변경될 수 있으므로, 오류 식별에는 error.message 대신 error.code 사용을 안내합니다.
출처
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js에서는 error.code가 오류 종류를 식별하는 문자열 레이블이며 오류 식별에 가장 안정적인 방법입니다., ERR_MODULE_NOT_FOUND는 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했을 때 사용됩니다. · 확인일: 2026-07-24