yarn 1 · 빌드·타입
오류 문구
The engine "node" is incompatible with this module. Expected version ">=20"
무슨 뜻인가
설치하려는 패키지가 package.json의 engines에 필요한 node 판을 적어 두었고, 지금 쓰는 판이 그 범위 밖이라는 뜻입니다. 뒤에 붙는 Expected와 Got이 요구 범위와 내 판을 나란히 보여 주니 그 둘만 보면 됩니다 — CI에서만 이 오류가 난다면 그곳의 node 판이 내 컴퓨터와 다른 것입니다. nvm install 20 && nvm use 20처럼 node를 올리는 것이 정면의 답이고, .nvmrc나 CI 설정에도 같은 판을 적어 두어야 다음에 또 갈라지지 않습니다. yarn의 --ignore-engines로 넘길 수는 있지만 그것은 경고를 지우는 것일 뿐 호환성을 만들어 주지 않아, 그 패키지가 새 문법을 쓰면 실행 중에 문법 오류로 터집니다. npm은 같은 상황을 EBADENGINE 경고로 알리고 기본적으로는 설치를 막지 않습니다.
고치는 명령
nvm install 20 && nvm use 20- 내는 도구
- yarn 1
- 빌드·타입
- 10
빌드가 내는 오류는 실행 전에 도구가 거절한 것이라 그 자리에서 프로그램을 망가뜨리지는 않지만 대신 두 가지를 물어봅니다 — 타입이나 경로를 실제 모양에 맞게 고칠 것인가, 아니면 as any나 인용 부호 하나로 그 줄만 통과시킬 것인가 — 그리고 대소문자와 확장자, 환경 변수처럼 내 컴퓨터에서만 맞는 것들은 여기서 처음 드러납니다.
오류 문구를 읽는 법
- 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
- 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
- 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
- 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
- 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.
자주 묻는 질문
Q. The engine "node" is incompatible with this module. Expected version ">=20" 는 무슨 뜻인가요?
설치하려는 패키지가 package.json의 engines에 필요한 node 판을 적어 두었고, 지금 쓰는 판이 그 범위 밖이라는 뜻입니다. 뒤에 붙는 Expected와 Got이 요구 범위와 내 판을 나란히 보여 주니 그 둘만 보면 됩니다 — CI에서만 이 오류가 난다면 그곳의 node 판이 내 컴퓨터와 다른 것입니다. nvm install 20 && nvm use 20처럼 node를 올리는 것이 정면의 답이고, .nvmrc나 CI 설정에도 같은 판을 적어 두어야 다음에 또 갈라지지 않습니다. yarn의 --ignore-engines로 넘길 수는 있지만 그것은 경고를 지우는 것일 뿐 호환성을 만들어 주지 않아, 그 패키지가 새 문법을 쓰면 실행 중에 문법 오류로 터집니다. npm은 같은 상황을 EBADENGINE 경고로 알리고 기본적으로는 설치를 막지 않습니다.
Q. 어떻게 고치나요?
nvm install 20 && nvm use 20 — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.
Q. 어느 도구가 내는 오류인가요?
yarn 1입니다. 빌드·타입 갈래에 있고, 문구는 11낱말입니다.