[Firebase] npm cache EACCES 오류 해결 (macOS)

firebase init functions 실행 중 의존성 설치 단계에서 아래 오류가 발생했다.

npm ERR! code EACCES
npm ERR! Your cache folder contains root-owned files
npm ERR! To permanently fix this problem, please run:
npm ERR! sudo chown -R 501:20 "/Users/upself/.npm"

error

% firebase init functions

     ######## #### ########  ######## ########     ###     ######  ########                                                                                                                                    
     ##        ##  ##     ## ##       ##     ##  ##   ##  ##       ##                                                                                                                                          
     ######    ##  ########  ######   ########  #########  ######  ######                                                                                                                                      
     ##        ##  ##    ##  ##       ##     ## ##     ##       ## ##                                                                                                                                          
     ##       #### ##     ## ######## ########  ##     ##  ######  ########                                                                                                                                    
                                                                                                                                                                                                               
이 디렉터리에서 Firebase 프로젝트를 초기화하려고 합니다.

/Users/upself/Downloads/UPSELF/Project/tistory

=== 프로젝트 설정

먼저 이 프로젝트 디렉토리를 Firebase 프로젝트와 연결해 보겠습니다.

firebase use --add, 명령어를 실행하여 여러 개의 프로젝트 별칭을 생성할 수 있습니다.

✔ 옵션을 선택하세요: 기존 프로젝트 사용
✔ 이 디렉토리에 대한 기본 Firebase 프로젝트를 선택하세요: upself-tistory(Upself Tistory)

=== 함수 설정
함수를 위한 새 코드베이스를 만들어 보겠습니다.

코드베이스에 해당하는 디렉토리가 프로젝트에 생성되며,
샘플 코드가 미리 구성되어 있습니다.

코드베이스를 사용하여 함수를 구성하는 방법에 대한 자세한 내용은 https://firebase.google.com/docs/functions/organize-functions 를 참조하세요.

함수는 firebase deploy 명령어로 배포할 수 있습니다.

✔ 클라우드 함수를 작성하는 데 사용할 언어를 선택하세요. 타입스크립트
✔ ESLint를 사용하여 잠재적인 버그를 잡아내고 스타일을 적용하시겠습니까? 예
✔ functions/.eslintrc.js 파일을 작성했습니다.
✔ ​​functions/tsconfig.dev.json 파일을 작성했습니다.
✔ ​​functions/package.json 파일을 작성했습니다.
✔ ​​functions/tsconfig.json 파일을 작성했습니다.
✔ ​​functions/src/index.ts 파일을 작성했습니다.
✔ ​​functions/.gitignore 파일을 작성했습니다.
✔ ​​npm을 사용하여 종속성을 설치하시겠습니까? 예
npm 오류 코드 EACCES
npm 오류 시스템 호출 open
npm 오류 경로 /Users/upself/.npm/_cacache/index-v5/23/7b/e1156c0b938a882c4a881a1607dd9ac6c191c49dae980a43314979c7c1b3
npm 오류 errno EACCES
npm 오류
npm 오류 이전 버전의 npm 버그로 인해 캐시 폴더에 루트 소유 파일이 포함되어 있습니다.

이 버그는 현재 해결되었습니다. npm 오류
npm 오류 이 문제를 영구적으로 해결하려면 다음 명령을 실행하세요.
npm 오류 sudo chown -R 501:20 "/Users/upself/.npm"
npm 오류 이 실행에 대한 전체 로그는 다음 위치에서 확인할 수 있습니다. /Users/upself/.npm/_logs/2026-06-16T08_48_26_560Z-debug-0.log

NPM 설치에 실패했습니다. Firebase 초기화를 계속 진행합니다...

=== 에이전트 스킬 설정
AI 코딩 에이전트를 사용하는 경우 Firebase 에이전트 스킬을 통해 Firebase 전문가가 될 수 있습니다.

✔ Firebase용 에이전트 스킬을 설치하시겠습니까? 아니요

✔ firebase.json에 구성 정보가 기록되었습니다.
✔ ​​.firebaserc에 프로젝트 정보가 기록되었습니다.

✔ Firebase 초기화가 완료되었습니다!

 

원인

이전에 sudo npm install을 사용하면서 .npm 캐시 폴더의 소유자가 root로 변경되어 발생한 권한 문제이다.

현재 사용자 계정이 npm 캐시 파일에 접근하지 못해 패키지 설치가 실패한 상태이다.

해결

npm 캐시 폴더의 소유권을 현재 사용자로 변경한다.

sudo chown -R 501:20 "/Users/upself/.npm"

 

권한 변경 후 다시 의존성을 설치한다.

cd functions && npm install

 

설치가 정상 완료되면 다음과 같이 출력된다.

added 715 packages

 

성공!

% cd functions && npm install

npm 경고: inflight@1.0.6 모듈은 더 이상 지원되지 않으며 메모리 누수가 발생합니다. 사용하지 마십시오. 키-값으로 비동기 요청을 통합하는 더 포괄적이고 강력한 방법을 원한다면 lru-cache를 확인하십시오.
npm 경고: rimraf@3.0.2 모듈은 더 이상 지원되지 않습니다. Rimraf v4 이전 버전은 더 이상 지원되지 않습니다.
npm 경고: glob@7.2.3 모듈은 더 이상 지원되지 않으며, 현재 버전에서 수정된 널리 알려진 보안 취약점이 포함되어 있습니다. 업데이트하십시오. 이전 버전에 대한 지원은 i@izs.me로 문의하여 (매우 높은 가격으로) 구매할 수 있습니다.
npm 경고: glob@7.2.3 모듈은 더 이상 지원되지 않으며, 현재 버전에서 수정된 널리 알려진 보안 취약점이 포함되어 있습니다. 업데이트하십시오. 이전 버전 지원은 i@izs.me로 문의하시면 (매우 높은 가격으로) 구매하실 수 있습니다.
npm 경고: @humanwhocodes/config-array@0.13.0 사용 중단: @eslint/config-array를 대신 사용하세요.
npm 경고: @humanwhocodes/object-schema@2.0.3 사용 중단: @eslint/object-schema를 대신 사용하세요.
npm 경고: node-domexception@1.0.0 사용 중단: 플랫폼의 네이티브 DOMException을 대신 사용하세요.
npm 경고: uuid@9.0.1 사용 중단: uuid@10 이하 버전은 더 이상 지원되지 않습니다. ESM 코드베이스의 경우 uuid@latest로 업데이트하세요. CommonJS 코드베이스의 경우 uuid@11을 사용하세요(단, 이 버전은 2028년에 사용이 중단될 가능성이 높습니다).

npm warn deprecated glob@10.5.0: glob의 이전 버전은 더 이상 지원되지 않으며, 널리 알려진 보안 취약점이 포함되어 있습니다. 이러한 취약점은 현재 버전에서 수정되었습니다. 업데이트하십시오. 이전 버전에 대한 지원은 i@izs.me로 문의하여 (매우 높은 가격으로) 구매할 수 있습니다.
npm warn deprecated eslint@8.57.1: 이 버전은 더 이상 지원되지 않습니다. 다른 옵션은 https://eslint.org/version-support를 참조하십시오.

715개의 패키지가 추가되었고, 10초 만에 716개의 패키지를 감사했습니다.

176개의 패키지가 자금 지원을 기다리고 있습니다.

자세한 내용은 `npm fund`를 실행하십시오.

중간 심각도의 취약점 27개

주의가 필요하지 않은 문제를 해결하려면 다음 명령을 실행하십시오.

npm audit fix

모든 문제(호환되지 않는 변경 사항 포함)를 해결하려면 다음 명령을 실행하십시오.

npm audit fix --force

자세한 내용은 `npm audit`를 실행하십시오.

 

참고

설치 후 아래와 같은 경고가 출력될 수 있다.

27 moderate severity vulnerabilities

 

이는 즉시 오류는 아니며 필요 시 아래 명령어로 점검 및 수정할 수 있다.

npm audit
npm audit fix

 

한 줄 정리

Your cache folder contains root-owned files 오류는 npm 캐시 폴더 권한 문제이며, chown으로 소유권을 변경한 뒤 npm install을 다시 실행하면 해결된다.