[npm install 오류] npm install 안될때

김zunyange·2023년 5월 25일

기존에 있던 코드를 로컬로 다시 클론받아 테스트 해볼려고 npm start 이전에 npm install을 하려고 보니 오류가 있었고, 두 개의 다른 작업물에서 모두 (다른) 오류가 발생했다.
나의 경우, npm install 오류가 난 적이 없었기에 오류 해결 과정을 기록해보고자 한다.

첫번째 프로젝트 파일

두번째 프로젝트 파일

🤔 원인

sudo권한으로 명령어를 실행해야 하는 경우
dependency 버전 문제
node와 npm 버전이 맞지 않는 경우 : 리액트 프로젝트 세팅시 항상 최신버전이 설치되므로, 다른 라이브러리와 호환이 안됨

🪄 npm install --verbose 명령어를 실행시켜 친절한 npm ERR이 알려주는 원인을 확인한다.

나는 첫번째 작업과 두번째 작업에서 모두

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree

🚨'dependency 버전' 오류가 떴고 셋 중 하나를 입력해준다. "기존버전 무시하고 설치한다"는 뜻이다.

$ npm install --force
$ npm install --save --legacy-peer-deps
$ npm install --legacy-peer-deps

🤷🏻‍♀️ --force VS --legacy-peer-deps

--force
package-lock.json에 다른 dependency 버전을 추가한다는 것.
충돌하는 peer dependency들을 루트 프로젝트에 설치하여 에러를 해결한다.

--legacy
peerDependency가 맞지 않아도 일단 설치한다는 것.

npm install --force를 실행시켜 다른 dependency 버젼을 추가하여 install 해보고 실패하면 npm install --legacy-peer-deps를 실행하면 된다.

💫 sudo권한으로 명령어를 실행해야 하는 경우 해결법

sudo 권한을 주고 설치를 한다.
$ sudo npm install
node_modules 폴더를 지우고, package-lock.json 파일을 지우고 다시 설치

$ rm -rf node_modules/
$ sudo rm -rf package-lock.json
$ npm install

💫 node와 npm 버전이 맞지 않는 경우

(1) node 버전 업그레이드

현재 설치되어있는 버전을 확인한다.
$ node -v
오류 방지를 위해 캐시를 삭제한다.
$ sudo npm cache clean -f
n 이라는 심플한 이름의 패키지는 Node.js 버전을 관리해주는 플러그인이다. 이 모듈을 이용해서 설치한다.
$ sudo npm install -g n
최신 버전 설치 $ n latest
안정 버전 설치 $ n stable
LTS 버전 설치 $ n lts
특정 버전 설치 예)$ n 0.8.14