Кратак одговор
Грешка npm ERR! сукоб зависности јавља се када два или више пакета захтевају различите верзије истог зависног пакета. Решење је да прегледате стабло зависности, ажурирате или закључате верзије, или привремено користите опцију --legacy-peer-deps. Не препоручује се игнорисање упозорења јер може довести до нестабилног рада апликације.
Како се проблем препознаје
- npm install пријављује ERESOLVE грешку
- Порука садржи 'унабле то ресолве dependency tree'
- Инсталација пакета не успева иако је раније радила
- Апликација се руши због некомпатибилних верзија пакета
- npm упозорава на peer dependency конфликт
Најчешћи узроци
Некомпатибилне peer зависности
Два пакета захтевају различите верзије истог peer dependency пакета, па npm не може да пронађе заједничку верзију.
Застарели пакети у пројекту
Неки пакети у package.json су застарели и захтевају старије верзије зависности које више нису компатибилне са новијим пакетима.
Ручно мењање package-lock.json
Ако је package-lock.json ручно мењан или је изостао, npm не може правилно да реши стабло зависности.
Коришћење npm верзије 7+
Новије npm верзије строже проверавају peer зависности, па се грешке које су раније биле скривене сада приказују.
Решење корак по корак
- 1
Прочитајте тачну поруку грешке
Покрените
npm installи пажљиво прочитајте поруку. npm обично наводи који пакет и које верзије су у сукобу. На основу тога знате које пакете треба ажурирати или прилагодити. - 2
Прегледајте стабло зависности
Покрените
npm ls <ime-paketa>да видите које верзије су инсталиране и ко их захтева. За детаљнији приказ користитеnpm ls --all. То вам помаже да идентификујете извор конфликта. - 3
Ажурирајте проблематичне пакете
Ако је узрок застарела верзија, покушајте са
npm update <ime-paketa>или ручно измените верзију у package.json на новију. Затим покренитеnpm installда проверите да ли је сукоб решен. - 4
Обришите node_модулес и package-lock.json
Понекад су преостали фајлови извор проблема. Пре брисања направите резервну копију фајла
package-lock.jsonили проверите да је стање commit-ovano у git. Затим обришите фолдерnode_modulesи фајлpackage-lock.json, па поново покренитеnpm install. Time се гради свеже стабло зависности. - 5
Користите --legacy-peer-deps као привремено решење
Ако не можете одмах да ажурирате пакете, покрените
npm install --legacy-peer-deps. Ова опција игнорише peer dependency конфликте и инсталира пакете као у старијим npm верзијама. Имајте у виду да то може довести до нестабилности. - 6
Користите --форце са опрезом
Опција
npm install --forceприсиљава инсталацију и може решити тврдокорне случајеве, али може покварити зависности. Користите је само ако претходни кораци нису успели и ако разумете ризик. - 7
Проверите компатибилност верзија Node.js
Неке грешке су последица некомпатибилне верзије Node.js са пакетима. Проверите да ли ваша верзија Node.js одговара захтевима пакета. Ако није, промените верзију помоћу алата за управљање верзијама.
- 8
Користите npm-цхецк-updates за ажурирање
Инсталирајте алат
npm-check-updatesглобално и покренитеncu -uда аутоматски ажурирате све верзије у package.json на најновије. Пре тога commit-ujte промене и проверите компатибилност, јерncu -uможе да пређе на нове мајор верзије. Затим покренитеnpm install. Ово је корисно за пројекте са много застарелих пакета.
Ако ништа не помогне
Ако су сви кораци испробани и грешка остаје, проверите да ли је проблем у самом npm регистру или у мрежи. Понекад је довољно проверити npm кеш командом npm cache verify, а ако сумњате на оштећење, тек онда га очистити са npm cache clean --force и покушати поново. Такође, размотрите коришћење алтернативног пацкаге manager-а као што је Yarn, који има другачији приступ решавању зависности. Ако ни то не успе, консултујте документацију пакета или заједницу. У тимским пројектима, обавезно обавестите колеге о променама у package.json и package-lock.json како bi сви имали усклађено окружење.
Како да спречите да се понови
- Редовно ажурирајте пакете и проверавајте застарелост са `npm outdated`.
- Користите package-lock.json и commit-ujte га у git.
- Избегавајте ручно мењање package-lock.json.
- Тестирајте инсталацију у чистом окружењу пре него што је поделите са тимом.
Када је боље позвати стручњака
Ако се сукоб зависности понавља и утиче на продуктивност тима, или ако нисте сигурни које верзије пакета су компатибилне, обратите се IT подршци. Они могу помоћи у анализи зависности и успостављању стабилног развојног окружења.
Развој софтвера и производа · Апликације по мери, SaaS и MVP за 4 до 8 недељаЧеста питања
Шта значи npm ERR! сукоб зависности?
То је грешка која се јавља када npm не може да пронађе верзију пакета која задовољава све захтеве. Најчешће се јавља због peer dependency конфликта између два или више пакета.
Да ли је --legacy-peer-deps сигурно решење?
Ова опција привремено решава проблем игнорисањем peer dependency конфликата. Међутим, може довести до тога да пакети не раде исправно ако су заиста некомпатибилни. Користите је само као привремено решење.
Како да спречим сукоб зависности у будућности?
Редовно ажурирајте пакете, користите package-lock.json и избегавајте ручно мењање. Такође, пратите упозорења npm-а и на време реагујте на застареле зависности.