Razumevanje i rešavanje npm ERESOLVE konflikata zavisnosti

Razumevanje i rešavanje npm ERESOLVE konflikata zavisnosti

Greška npm ERESOLVE znači da npm nije mogao da izgradi stablo zavisnosti koje zadovoljava sva pravila verzija — najčešće zbog peer dependencies. Od verzije npm 7, peer zavisnosti se strogo obrađuju tokom instalacije, pa konflikti koji su se ranije instalirali „uprkos svemu“ sada brzo otkazuju.

Ta strogost smanjuje iznenađenja tokom izvršavanja, ali može blokirati instalacije kada jedan paket očekuje starije verzije od onih u vašem projektu.

Brza trijaža: Pronađite stvarni konflikt

Pre nego što bilo šta forsirate, identifikujte ko šta zahteva. Ove komande obično precizno ukazuju na krivca za manje od minuta.

npm -v
node -v

# prikaži lanac zavisnosti
npm ls @tensorflow/tfjs
npm ls react

# prikaži zahteve peer zavisnosti
npm view @tensorflow-models/handpose peerDependencies

# objasni zašto je verzija izabrana
npm explain @tensorflow/tfjs

Zašto dolazi do konflikata peer zavisnosti

Peer dependencies su ugovori o kompatibilnosti. Biblioteka kaže: „Ja ne isporučujem React / TFJS sama — vi morate obezbediti kompatibilnu verziju.“ Konflikti se dešavaju kada dva paketa zahtevaju nekompatibilne opsege verzija.

• Paket A zahteva @tensorflow/tfjs ^3, ali vaš projekat instalira @tensorflow/tfjs@4.
• Dodatak zahteva react@^17, dok je vaša aplikacija na react@18.
• Pomešali ste glavne (major) verzije u porodici paketa (npr. tfjs core v4, backend-ovi su i dalje v3).

Kako popraviti npm ERESOLVE (Najbezbednije → Najagresivnije)

1) Poravnajte verzije (Najbolje dugoročno rešenje)

Zadržite jednu kompatibilnu glavnu verziju u celoj porodici zavisnosti. Ovo je rešenje koje opstaje kroz CI, implementacije i buduće nadogradnje.

// package.json (primer: poravnanje tfjs porodice na v3)
{
  "dependencies": {
    "@tensorflow/tfjs": "^3.21.0",
    "@tensorflow/tfjs-backend-webgl": "^3.21.0",
    "@tensorflow/tfjs-backend-cpu": "^3.21.0",
    "@tensorflow-models/handpose": "^0.0.7"
  }
}

rm -rf node_modules package-lock.json
npm install

2) Koristite npm „overrides“ (Kontrolisano forsiranje, npm 8+)

Koristite overrides kada tranzitivna zavisnost povuče pogrešnu verziju. Ovo je bezbednije od --force, ali morate testirati ponašanje tokom izvršavanja.

// package.json
{
  "overrides": {
    "@tensorflow/tfjs": "^4.0.0",
    "@tensorflow/tfjs-backend-webgl": "^4.0.0",
    "@tensorflow/tfjs-backend-cpu": "^4.0.0"
  }
}

rm -rf node_modules package-lock.json
npm install

3) --legacy-peer-deps (Brzo odblokiranje, manja bezbednost)

Zaobilazi strogo razrešavanje peer zavisnosti i ipak instalira. Dobro za brze eksperimente — rizično kao podrazumevana opcija u produkciji.

npm install --legacy-peer-deps

4) --force (Poslednje rešenje)

Prisiljava instalaciju čak i kada npm zna da je stablo nekonzistentno. Koristite samo ako prihvatate potencijalne prekide u radu (runtime).

npm install --force

5) Kontrolna lista za čistu instalaciju (popravlja čudna stanja lockfile-a)

rm -rf node_modules package-lock.json
npm cache verify
npm install

npm vs pnpm vs Yarn: Praktične razlike

Sva tri mogu naići na peer konflikte, ali se razlikuju po brzini, strategiji za node_modules i po tome koliko brzo otkrivaju "skrivene" greške u zavisnostima.

npm (v7+): podrazumevano strog

• Prednosti: rano hvata nekompatibilne peer kombinacije; predvidljiv CI.
• Mane: češće blokira instalacije; ljudi pribegavaju flegovima (flags).
• Najbolje za: timove koji žele strogu ispravnost umesto pogodnosti.

pnpm: brz, efikasan sa diskom, stroži pristup zavisnostima

pnpm koristi globalno skladište adresabilno po sadržaju i linkuje pakete. Instalacije su obično brže i troše manje diska. Njegov stroži raspored može ranije otkriti direktne zavisnosti koje nedostaju.

corepack enable
corepack prepare pnpm@latest --activate

pnpm install

Yarn: moćni alati za radne prostore (workspaces), fleksibilna razrešavanja

Yarn je popularan u monorepoima. U zavisnosti od verzije/konfiguracije Yarn-a, može delovati popustljivije, ali velika prednost su radni prostori (workspaces) i mogućnost fiksiranja verzija putem resolutions.

corepack enable
corepack prepare yarn@stable --activate

yarn install

# package.json (Yarn) -> "resolutions": { "react": "18.2.0" }

Zaključak

Za produkciju: preferišite usklađivanje verzija ili kontrolisana premošćavanja (overrides). Koristite --legacy-peer-deps da biste brzo odblokirali proces, a --force sačuvajte kao poslednje rešenje. Ako su instalacije spore ili je repozitorijum veliki, pnpm je često dobra nadogradnja. Ako su radni prostori (workspaces) i strogo fiksiranje verzija bitni, Yarn je dobar izbor.

Isečci za kopiranje/lepljenje

# najsigurnije: uskladite verzije
rm -rf node_modules package-lock.json
npm install

# kontrolisano: premošćavanja (overrides)
# package.json -> "overrides": { "pkg": "version" }

# brzo odblokiranje
npm install --legacy-peer-deps

# poslednje rešenje
npm install --force