node.js/npm | error ERESOLVE could not resolve 에러 해결하기

프로젝트를 다운로드 받아 의존성 설치를 위해 아래의 명령어를 실행했다.

$ npm i

 

어김없이 나타나는 에러 메시지!

npm warn ERESOLVE overriding peer dependency
npm warn While resolving: @mui/base@5.0.0-beta.27
npm warn Found: @types/react@19.1.10
npm warn node_modules/@types/react
npm warn   @types/react@"^19.1.10" from the root project
npm warn   9 more (@mui/private-theming, @mui/system, @mui/types, ...)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional @types/react@"^17.0.0 || ^18.0.0" from @mui/base@5.0.0-beta.27
npm warn node_modules/@mui/base
npm warn   @mui/base@"5.0.0-beta.27" from @mui/material@5.15.0
npm warn   node_modules/@mui/material
npm warn
npm warn Conflicting peer dependency: @types/react@18.3.24
npm warn node_modules/@types/react
npm warn   peerOptional @types/react@"^17.0.0 || ^18.0.0" from @mui/base@5.0.0-beta.27
npm warn   node_modules/@mui/base
npm warn     @mui/base@"5.0.0-beta.27" from @mui/material@5.15.0
npm warn     node_modules/@mui/material
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: @mui/icons-material@5.15.0
npm error Found: @types/react@19.1.10
npm error node_modules/@types/react
npm error   @types/react@"^19.1.10" from the root project
npm error   peerOptional @types/react@"^17.0.0 || ^18.0.0 || ^19.0.0" from @mui/private-theming@5.17.1
npm error   node_modules/@mui/private-theming
npm error     @mui/private-theming@"^5.17.1" from @mui/system@5.18.0
npm error     node_modules/@mui/system
npm error       @mui/system@"^5.15.0" from @mui/material@5.15.0
npm error       node_modules/@mui/material
npm error         @mui/material@"^5.15.0" from the root project
npm error         1 more (@mui/icons-material)
npm error   8 more (@mui/system, @mui/types, @mui/types, @mui/utils, ...)
npm error
npm error Could not resolve dependency:
npm error peerOptional @types/react@"^17.0.0 || ^18.0.0" from @mui/icons-material@5.15.0
npm error node_modules/@mui/icons-material
npm error   @mui/icons-material@"^5.15.0" from the root project
npm error
npm error Conflicting peer dependency: @types/react@18.3.24
npm error node_modules/@types/react
npm error   peerOptional @types/react@"^17.0.0 || ^18.0.0" from @mui/icons-material@5.15.0
npm error   node_modules/@mui/icons-material
npm error     @mui/icons-material@"^5.15.0" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /Users/.../.npm/_logs/2025-09-05T01_42_33_463Z-eresolve-report.txt
npm error A complete log of this run can be found in: /Users/.../.npm/_logs/2025-09-05T01_42_33_463Z-debug-0.log

 

우선은 아래와 같이 --leagacy-peer-deps 옵션을 사용했더니 위에서 나타난 오류는 해결되었다.

$ npm i --legacy-peer-deps

 

아래와 같이 실행된다.

npm warn deprecated workbox-cacheable-response@6.6.0: workbox-background-sync@6.6.0
npm warn deprecated workbox-google-analytics@6.6.0: It is not compatible with newer versions of GA starting with v4, as long as you are using GAv3 it should be ok, but the package is not longer being maintained
npm warn deprecated w3c-hr-time@1.0.2: Use your platform's native performance.now() and performance.timeOrigin.
npm warn deprecated svgo@1.3.2: This SVGO version is no longer supported. Upgrade to v2.x.x.
npm warn deprecated stable@0.1.8: Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility
npm warn deprecated sourcemap-codec@1.4.8: Please use @jridgewell/sourcemap-codec instead
npm warn deprecated rollup-plugin-terser@7.0.2: This package has been deprecated and is no longer maintained. Please use @rollup/plugin-terser
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated q@1.5.1: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other.
npm warn deprecated
npm warn deprecated (For a CapTP with native promises, see @endo/eventual-send and @endo/captp)
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated eslint@8.57.1: This version is no longer supported. Please see https://eslint.org/version-support for other options.
npm warn deprecated domexception@2.0.1: Use your platform's native DOMException instead
npm warn deprecated abab@2.0.6: Use your platform's native atob() and btoa() methods instead
npm warn deprecated @humanwhocodes/config-array@0.13.0: Use @eslint/config-array instead
npm warn deprecated @humanwhocodes/object-schema@2.0.3: Use @eslint/object-schema instead
npm warn deprecated @mui/base@5.0.0-beta.27: This package has been replaced by @base-ui-components/react
npm warn deprecated @babel/plugin-proposal-optional-chaining@7.21.0: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-optional-chaining instead.
npm warn deprecated @babel/plugin-proposal-private-methods@7.18.6: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-private-methods instead.
npm warn deprecated @babel/plugin-proposal-numeric-separator@7.18.6: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-numeric-separator instead.
npm warn deprecated @babel/plugin-proposal-nullish-coalescing-operator@7.18.6: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-nullish-coalescing-operator instead.
npm warn deprecated @babel/plugin-proposal-class-properties@7.18.6: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-class-properties instead.
npm warn deprecated source-map@0.8.0-beta.0: The work that was done in this beta branch won't be included in future versions
npm warn deprecated @babel/plugin-proposal-private-property-in-object@7.21.11: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-private-property-in-object instead.

added 1393 packages, and audited 1394 packages in 18s

278 packages are looking for funding
  run `npm fund` for details

9 vulnerabilities (3 moderate, 6 high)

To address all issues (including breaking changes), run:
  npm audit fix --force

Run `npm audit` for details.

 

우선은 에러 없이 진행되었으니 이대로 사용하고, --leagacy-peer-deps 옵션에 대해서는 다시 한번 더 찾아봐야겠다.