DEV WIKI
백엔드 · 오류 메시지·상태명 확인

MODULE_NOT_FOUND

CommonJS 모듈 로더가 `require()` 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 나타내는 Node.js 오류 코드입니다.

빠른 답변

확인 범위
`MODULE_NOT_FOUND`는 CommonJS 모듈 로더가 `require()` 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 의미합니다.
먼저 확인할 항목
현재 화면 또는 로그의 오류 코드가 `MODULE_NOT_FOUND`와 정확히 일치하는지 확인합니다.
적용 범위
화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우문맥: 바이브 코딩
출처
Node.js
출처 확인일
2026-07-24
최종 검토
2026-07-24
오류·수정 제보 (새 창에서 열림)

이 문서의 범위

이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.

현재 증상

  • 애플리케이션 오류 메시지

먼저 확인할 항목

현재 화면 또는 로그의 오류 코드가 `MODULE_NOT_FOUND`와 정확히 일치하는지 확인합니다.

일치할 경우 CommonJS `require()` 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했다는 원문 설명과 대조합니다.

오류 메시지·상태명 확인 범위

확인

현재 화면 또는 로그의 오류 코드가 MODULE_NOT_FOUND와 일치하는지 확인합니다.

일치하면 Node.js 공식 문서 기준으로 CommonJS 모듈 로더가 require() 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못한 경우입니다.

범위

이 문서는 오류 코드 식별만 다룹니다. 원문은 이 오류 코드에 대한 복구 절차를 제공하지 않습니다.

출처

참고 자료

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

Node.js · 공식 자료 · 확인 범위: Node.js 오류 코드는 `error.code`로 식별하는 것이 가장 안정적입니다., `MODULE_NOT_FOUND`는 CommonJS 모듈 로더가 `require()` 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했을 때의 오류 코드입니다. · 확인일: 2026-07-24