갑자기 React에서 ‘create-react-app’ 명령을 실행할 수 없습니다. 이런 일이 일어나는 이유는 무엇이며 어떻게 해결할 수 있을까요?
React에서 ‘create-react-app’ 명령을 실행할 수 없는 문제를 겪고 있다면, 혼자가 아닙니다. 이 문제는 종종 설치되는 패키지의 의존성 트리에 충돌이 있는 경우 발생합니다. 다행히도 이 문제를 해결하기 위해 시도할 수 있는 몇 가지 해결책이 있습니다.
해결책 1: ‘–legacy-peer-deps’ 플래그 사용하기
첫 번째 해결책은 명령을 실행할 때 ‘–legacy-peer-deps’ 플래그를 사용하는 것입니다. 이 플래그는 npm 버전 7에서 도입되었으며 peerDependency 자동 설치를 우회할 수 있게 해줍니다. 이 플래그를 사용하면 npm에게 peer dependencies를 무시하고 설치를 진행하도록 지시합니다. 다음 명령을 실행하여 이 플래그를 사용하세요:
npm config set legacy-peer-deps true‘legacy-peer-deps’ 설정을 ‘true’로 설정함으로써 의존성 충돌을 극복하고 설치 과정을 계속할 수 있습니다.
해결책 2: React 및 React-DOM 버전 낮추기
첫 번째 해결책이 작동하지 않는다면, ‘package.json’ 파일에서 React 및 React-DOM의 버전을 낮추는 것이 좋습니다. 이렇게 하면 다른 패키지와의 호환성 문제를 해결할 수 있습니다. 다음과 같이 ‘react’ 및 ‘react-dom’ 의존성을 업데이트하세요:
"react": "^17.0.0",
"react-dom": "^17.0.0"이러한 변경 사항을 적용한 후 프로젝트의 ‘node_modules’ 폴더를 삭제하고 다음 명령을 실행하여 의존성을 재설치하세요:
npm install해결책 3: 캐시 지우고 패키지 재설치하기
위의 해결책들이 작동하지 않는다면, npm 캐시를 지우고 패키지를 재설치해 보세요. 다음 명령을 실행하세요:
npm cache clean --force
npm installnpm 캐시를 지우고 패키지를 재설치함으로써 충돌하는 의존성 없이 깨끗한 설치를 보장할 수 있습니다.
해결책 4: 상위 의존성 충돌 확인하기
이전 해결책들이 모두 작동하지 않는다면, 상위 의존성 충돌이 있을 수 있습니다. 이 경우 오류 로그를 검사하여 구체적인 충돌을 식별하고 수동으로 수정해 보세요. 오류 로그는 다음 경로에서 찾을 수 있습니다:
/home/zahid/.npm/eresolve-report.txt보고서를 검토하여 충돌하는 의존성을 확인하고 필요한 변경 사항을 적용해 문제를 해결할 수 있습니다.
결론
React에서 ‘create-react-app’ 명령에 문제가 발생하는 것은 충돌하는 의존성으로 인한 일반적인 문제입니다. 이 게시물에서 설명한 ‘–legacy-peer-deps’ 플래그 사용, 패키지 버전 낮추기, npm 캐시 지우기 또는 상위 의존성 충돌 확인 등의 해결책을 따라서 이러한 장애물을 성공적으로 극복하고 React 애플리케이션을 문제없이 계속해서 개발할 수 있습니다.
