🔥 Trouble Shooting - CLI의 복수, Yarn 설치로 길을 잃다!

🤔 문제상황

zsh: command not found: yarn
이전 포스트, yarn을 잘못 yarn install 했던것이 화근이 되어 또 문제가 발생했다. yarn으로 설정된 외부 프로젝트를 실행하기 위해 yarn 명령어를 시작하니.. 아래와 같은 경고 메시지가 출력되었다.

! The local project doesn't define a 'packageManager' field. Corepack will now add one referencing yarn@4.6.0+sha512.5383cc12567a95f1d668fbe762dfe0075c595b4bfff433be478dbbe24e05251a8e8c3eb992a986667c1d53b6c3a9c85b8398c35a960587fbd9fa3a0915406728.
! For more details about this field, consult the documentation at https://nodejs.org/api/packages.html#packagemanager

📕 원인

• Corepack는 Node.js에서 제공하는 패키지 관리 도구로, Yarn, pnpm 등과 같은 패키지 관리자를 관리하고 자동으로 설치하는 역할을 한다.
• 이 경고 메시지는 현재 프로젝트가 packageManager 필드를 정의하지 않아서 발생한다. packageManager 필드는 프로젝트에서 사용하고 있는 패키지 관리자(npm, yarn, pnpm 등)를 명시하는 필드로, Corepack이 이를 자동으로 추가하려는 상황이다.
• 이 문제는 기본적으로 Corepack이 프로젝트에서 사용할 패키지 관리자를 정확하게 알 수 없기 때문에, packageManager 필드를 자동으로 추가하면서 경고를 발생시킨 것이다.

🥲 문제 해결 시도

1. yarn의 버전 다운그레이드 시도

corepack disable
npm uninstall -g yarn
npm install -g yarn@3

yarn install시에 자동으로 최신버전으로 설치가 된것.
Yarn 4에서 패키지 매니저 관련 설정을 자동으로 추가하는 과정이 생긴다고 한다.
그래서 그 전 버전인 3버전으로 설치하려 시도.

여기서 내가 간과한것

아 맞다.. yarn 3도 yarn berry 일텐데..?

(당연히 실패 하였다. 일반적으로 많이 사용되는 yarn버전은 구버전일테니.. 1.xx버전으로 설치하는 것이 옳은 방법일 것 같다고 생각)

yarn -v

zsh: command not found: yarn

OK 그럼 1.xx 버전으로 다시 설치 해보지 뭐..

2. yarn의 버전을 1.xx로 변경

🚀 Yarn 1.x(클래식)으로 다운그레이드하는 방법

1️⃣ Yarn 최신 버전 제거

npm uninstall -g yarn

2️⃣ Yarn 1.x 설치

npm install -g yarn@1.22.19

1.22.19가 안정적인 최신 Yarn 1 버전이기 때문에 이 버전을 사용하였다..

3️⃣ 버전 확인

yarn -v

zsh: command not found: yarn

이 방법 역시도 안됐다.. 하..

찾아보니 yarn이 제대로 설치되지 않은 이유는.. npm이 yarn을 설치하고 나서도 yarn이 시스템에 인식되지 않아 발생한 문제라고 한다. PATH 설정이 잘못됐을 가능성이 있다는것

🥳 문제 해결

PATH에 수동으로 경로 추가

1️⃣ npm의 전역 설치 경로 확인

npm bin -g

2️⃣ yarn 경로 확인

ls /usr/local/bin/yarn

주소는 1번 명령어 실행 시 조회된 주소를 입력하면 된다
근데 내 폴더에서는

npm	npx	pnpm	pnpx	yarn	yarnpkg

yarn이 존재했다...?
아.. 경로를 잘못지정해서 인식을 못하는구나

3️⃣ ~/.zshrc(혹은 사용하는 쉘 설정 파일)에 PATH를 추가

echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc

그리고

 source ~/.zshrc

Your user’s .npmrc file (${HOME}/.npmrc)
has a `globalconfig` and/or a `prefix` setting, which are incompatible with nvm.
Run `nvm use --delete-prefix v18.20.5 --silent` to unset it.

과연...

yarn -v
1.22.19

휴.. yarn 재설치가 되었다...

👍 결론

문제 해결을 적다보니 yarn의 버전 탓이라 생각할 수 있겠지만..
나의 근본적인 원인은 Corepack이 자동으로 Yarn 4.x를 사용하려고 시도했기 때문이였다. 이로 인해 버전 불일치와 호환성 문제가 발생했고, 해결책은 yarn을 1.x 버전으로 다운그레이드한 것

1. Corepack 문제

Corepack은 npm이 기본적으로 제공하는 툴로, 프로젝트 내에서 사용하는 패키지 매니저의 버전을 자동으로 관리하는 기능을 제공함

• Corepack은 yarn이나 pnpm 같은 패키지 매니저를 자동으로 관리하려고 시도하는데..
• 프로젝트 내에서 패키지 매니저를 정의하는 packageManager 필드가 없다면, Corepack은 자동으로 최신 버전을 사용하려고 하기 때문에 문제가 발생.
• Corepack이 최신 yarn 버전인 Yarn 4.x를 사용하려 했고, 그로 인해 yarn 버전 호환성 문제나 예기치 않은 동작이 일어난 것

2. 버전 불일치 문제

• 현재 yarn의 최신 버전은 Yarn 4.x 버전인데, 이는 "Yarn Berry". 이 버전은 이전 버전들과 호환성 차이가 존재해서, 기존 프로젝트에서는 예상치 못한 문제가 발생할 수 있음.
• 특히, Yarn 4.x는 이전 버전의 Yarn 1.x와 다른 설정 방식, 명령어, 동작 방식을 가지고 있어서 기존 프로젝트에서 사용된 yarn 버전과 호환되지 않았던 것
• 그래서 Corepack이 자동으로 최신 버전을 사용하는 과정에서 예상치 못한 문제가 발생했고, 이로 인해 yarn 관련 명령어가 제대로 동작하지 않았던 것

😿 회고: Yarn 설치 문제의 교훈

이 모든 문제는 결국 yarn install을 잘못 작성했기 때문에 발생했다. 사실, 작은 실수 하나가 이렇게 큰 문제를 일으킬 줄은 몰랐는데..

핵심 문제: 잘못된 yarn install 사용

CLI 명령어는 정말 강력하고 무서운 도구라는 걸 다시 한 번 깨닫게 되는 것 같다.