ERR_PACKAGE_PATH_NOT_EXPORTED
빠른 답변
- 이 오류는 무엇인가요?
- Node.js에서 요청한 패키지 하위 경로가 package.json의 "exports"에 공개되지 않았음을 나타내는 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- ERR_PACKAGE_PATH_NOT_EXPORTED는 package.json의 "exports" 필드가 요청한 하위 경로를 내보내지 않을 때 발생합니다.
- 무엇을 먼저 확인해야 하나요?
- 오류 객체 또는 로그의 error.code 값이 ERR_PACKAGE_PATH_NOT_EXPORTED와 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체 또는 로그의 error.code 값이 ERR_PACKAGE_PATH_NOT_EXPORTED와 일치하는지 확인합니다.
일치할 경우 package.json의 "exports" 필드가 요청한 하위 경로를 내보내지 않는다는 공식 의미로 식별합니다.
환경별 원인과 조치
확인
- 오류 객체 또는 로그에서
error.code값을 확인합니다. - 값이
ERR_PACKAGE_PATH_NOT_EXPORTED와 일치하는지 비교합니다. - 일치하면 요청한 패키지 하위 경로가 해당 패키지의
package.json"exports"필드에 공개되지 않은 상태입니다.
Node.js 문서는 오류 메시지 문자열이 모든 버전에서 변경될 수 있으므로 오류 식별에는 error.code를 사용하도록 안내합니다.
범위
이 문서는 오류 코드 식별과 공식 의미만 다룹니다. 패키지 설정이나 import 경로 변경 절차는 제공하지 않습니다.
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js 오류 객체의 error.code는 오류 종류를 식별하는 문자열 레이블입니다., Node.js는 오류 식별에 error.message 대신 error.code 사용을 권장합니다., ERR_PACKAGE_PATH_NOT_EXPORTED는 package.json의 "exports" 필드가 요청한 하위 경로를 내보내지 않을 때 사용됩니다., 내보내지 않은 private internal module은 절대 URL을 사용하지 않는 한 패키지 해석으로 import할 수 없습니다. · 확인일: 2026-07-24