버전 에러 (node, react, next)

Debug-Life ·2023년 9월 14일

포스팅 이유

예전에도 그랬지만 종속성 에러는 항상 처리하기 까다롭게 느껴져서 매번 대충 처리하곤 했었다.
그런데 이번 기회에 관련 문제들을 확실하게 처리하고 다음번에 비슷한 에러가 발생하더라도 잘 처리하도록 하기 위해서 기록을 남긴다.

회사에서 감사하게도 업무시간에 관련 기술과 관련된 강의를 들을 수 있게 배려해주셨다. 데모 프로젝트를 진행하면서 생긴 이슈들을 기록으로 남긴다.

문제 발생

next.js demo 프로젝트를 하던 도중 처음 종속성 에러가 발생했다.

서버 시작을 위해서 npm run dev 실행했으나 package.json.lock 스크립트 에러 발생
원인분석 : npm install --verbose
해결 : package.json 에서 react version up

위 에러문구 해석해보자면,

react 17.0.1 에서 오류가 발생했다.
next13.4.19 버전에서는 최소한 react 18.2.0 버전을 요구한다.
따라서 package.json에 버전 업해서 다시 종속성 설치를 진행한다.

바보같이 npm install --force 로 진행했지만 에러는 여전히 동일했다. 왜냐하면 호환성 경고, 검증 경고를 무시하고 종속성을 설치 해야하는게 아니라 호환되는 패키지 모듈을 설치해야하기 때문에.

문제 해결

"react": "18.2.0",
"react-dom": "18.2.0"

{
  "name": "nextjs-course",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  },
  "dependencies": {
    "next": "^13.4.19",
    "react": "18.2.0",
    "react-dom": "18.2.0"
  }
}

명령어 해석

npm install --verbose
일반적으로 사용자에게 보여주지 않는 내부 작업과 세부 정보까지 화면에 출력

npm install --force
npm에 패키지를 강제로 설치하라고 지시
호환성 경고, 검증 경고 무시하고 종속성 설치함. 따라서 에러 발생 위험이 있다.