ERR_UNSUPPORTED_DIR_IMPORT
빠른 답변
- 이 오류는 무엇인가요?
- Node.js에서 디렉터리 URL을 import할 때 발생하는 오류입니다.
- 가장 흔한 원인은 무엇인가요?
- ERR_UNSUPPORTED_DIR_IMPORT는 디렉터리 URL import가 지원되지 않을 때 발생하며, 원문 예시처럼 index.js를 직접 import하거나 패키지 이름과 package.json의 "exports" 하위 경로를 사용해야 합니다.
- 무엇을 먼저 확인해야 하나요?
- 현재 화면 또는 로그의 error.code가 ERR_UNSUPPORTED_DIR_IMPORT와 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
현재 화면 또는 로그의 error.code가 ERR_UNSUPPORTED_DIR_IMPORT와 일치하는지 확인합니다.
오류가 난 import 대상이 디렉터리 URL인지 확인합니다.
피해야 할 조치
주의
- 코드를 변경하기 전에 현재 import 구문과 대상 값을 기록합니다.
- 가능하면 변경 전 상태를 백업하거나 버전 관리 상태로 보존합니다.
- 한 번에 import 항목 하나만 변경합니다.
- 변경 후 장애 또는 오류가 발생하면 기록한 이전 값으로 복구합니다.
환경별 원인과 조치
의미
ERR_UNSUPPORTED_DIR_IMPORT는 디렉터리 URL을 import하려 할 때 발생합니다.
확인
- 현재 화면 또는 로그의
error.code가ERR_UNSUPPORTED_DIR_IMPORT와 일치하는지 확인합니다. - 오류가 난 import 대상이 디렉터리 URL인지 확인합니다.
error.code가 일치하면 Node.js가 정의한 이 오류 코드에 해당합니다. error.message 문자열은 버전 간 변경될 수 있으므로 식별 기준으로 사용하지 않습니다.
복구
원문 예시처럼 디렉터리 자체를 import하지 않고 ./index.js를 직접 import합니다. 패키지를 참조하는 경우에는 패키지 이름을 self-reference하고 package.json의 "exports" 필드에 사용자 정의 하위 경로를 정의합니다.
출처
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js는 오류 식별에 error.message 대신 error.code 사용을 권장합니다., ERR_UNSUPPORTED_DIR_IMPORT는 디렉터리 URL import가 지원되지 않을 때 발생합니다., 원문은 './index.js' 직접 import와 패키지 이름 import 예시를 지원되는 방식으로 제시합니다. · 확인일: 2026-07-24