DEV WIKI
백엔드 · 오류·증상

EACCES (Permission denied)

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

빠른 답변

이 오류는 무엇인가요?
Node.js에서 EACCES 오류 코드를 확인하고 파일 접근 권한으로 금지된 접근인지 식별합니다.
가장 흔한 원인은 무엇인가요?
EACCES는 파일 접근 권한이 금지한 방식으로 파일에 접근하려 할 때 나타나는 Node.js 시스템 오류입니다.
무엇을 먼저 확인해야 하나요?
현재 오류 객체 또는 로그의 `error.code`가 `EACCES`인지 확인합니다.

현재 증상

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

먼저 확인할 항목

현재 오류 객체 또는 로그의 `error.code`가 `EACCES`인지 확인합니다.

`error.code`가 `EACCES`이면 파일 접근 권한으로 금지된 방식의 파일 접근 시도를 뜻합니다.

환경별 원인과 조치

확인 방법

  1. 현재 오류 객체 또는 로그에서 error.code 값을 확인합니다.
  2. 값이 EACCES와 일치하면 Node.js 문서의 EACCES (Permission denied) 오류로 식별합니다.
  3. 이 오류는 파일 접근 권한이 금지한 방식으로 파일에 접근하려 한 경우를 뜻합니다.

error.message 문자열은 Node.js 버전 사이에서 변경될 수 있으므로 오류 식별에는 error.code를 사용합니다.

참고 자료

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

Node.js · 공식 자료 · 확인 범위: Node.js는 EACCES를 파일 접근 권한으로 금지된 방식의 파일 접근 시도로 설명합니다., Node.js 오류의 error.code는 오류 종류를 식별하는 문자열이며, error.message보다 안정적인 식별 방법입니다. · 확인일: 2026-07-24