React: 의존성 충돌 해결 방법

이건 임시방편이고 보안이나 실제 배포 시에는 오류 발생 ʕ•̀⤙•́ ʔ

의존성 충돌 해결 방법 3가지

에러 메시지에 따르면, @toast-ui/react-editor@3.2.3가 react@^17.0.1을 요구하지만, 현재 프로젝트는 react@19.1.0을 사용하고 있어서 의존성 충돌이 발생하고 있습니다.

방법 1: --legacy-peer-deps 옵션 사용

• 의존성 검사를 완화시켜 강제로 설치합니다. 가장 간단한 해결책입니다:

npm install --legacy-peer-deps

이 방법은 npm이 peer dependency 충돌을 무시하고 설치를 진행하게 합니다.

방법 2: 강제로 설치 (--force)

• 문제 의존성을 무시하고 설치하지만, 충돌로 인해 런타임 오류가 발생할 수도 있습니다.

npm install --force

방법 3: @toast-ui/react-editor 버전 업그레이드

• 현재 사용하는 react@19을 지원하는 @toast-ui/react-editor의 최신 버전으로 업데이트해 충돌을 근본적으로 해결합니다.

  1. npm info @toast-ui/react-editor 또는 npm 페이지에서 지원되는 React 버전 확인

  2. 예: 2025년 7월 기준으로 4.x 이상 버전이 React 18+를 지원할 수 있음

  3. 다음 명령어로 업데이트:

  npm install @toast-ui/react-editor@latest

• 단, 최신 버전 사용 시 코드 호환성 확인이 필요합니다. API가 변경됐을 수 있습니다.

권장 순서

1. 먼저 --legacy-peer-deps로 임시 해결

2. 나중에 @toast-ui/react-editor를 최신 버전으로 업그레이드 및 테스트

• 필요 시 package.json 정리와 재설치도 가능

rm -rf node_modules package-lock.json
npm install --legacy-peer-deps