DEV WIKI
백엔드 · 오류·증상

MODULE_NOT_FOUND

저자
Woody
최종 검토
2026-07-24
참고 자료
있음
관련 기술

빠른 답변

이 오류는 무엇인가요?
CommonJS 모듈 로더가 `require()` 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 나타내는 Node.js 오류 코드입니다.
가장 흔한 원인은 무엇인가요?
`MODULE_NOT_FOUND`는 CommonJS 모듈 로더가 `require()` 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 의미합니다.
무엇을 먼저 확인해야 하나요?
현재 화면 또는 로그의 오류 코드가 `MODULE_NOT_FOUND`와 정확히 일치하는지 확인합니다.

현재 증상

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

먼저 확인할 항목

현재 화면 또는 로그의 오류 코드가 `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