ERESOLVE unable to resolve dependency tree ترجمتها «ما قدر يحل شجرة الاعتماديات». معناها: حزمة في منتجك تشترط نسخة من حزمة ثانية، غالبًا React، غير النسخة اللي عندك، و npm رفض يختار عنك. فوقف التثبيت أو النشر.
الترجمة كلمة بكلمة
| الرسالة | الترجمة | إيش تعني |
|---|---|---|
npm ERR! code ERESOLVE أو npm error code ERESOLVE | خطأ npm، الرمز ERESOLVE | الصيغة الثانية في إصدارات npm الأحدث، والمعنى واحد |
unable to resolve dependency tree | ما قدر يحل شجرة الاعتماديات | ما لقى نسخ ترضي كل الحزم مع بعض |
Found: react@19.0.0 | الموجود: react 19 | النسخة اللي في منتجك |
Could not resolve dependency: peer react@"^18.0.0" from some-calendar@2.1.0 | ما قدر يحل اعتمادية: some-calendar تبي react 18 | هذي الحزمة اللي سبّبت التعارض |
peer dependency | اعتمادية مرافقة | شرط من حزمة إنها تشتغل مع نسخة معيّنة من حزمة ثانية |
وين تشوفها، وليش ما تطلع بالعربي
تطلع في سجل البناء على Vercel أو Netlify، أو في الـ Terminal لما تثبّت حزمة. ورسائل npm ما تتترجم، فبتشوفها بالإنجليزي دائمًا.
مشكلتك ولا مشكلة الموقع؟
- إذا أنت زائر: ما تشوفها. الموقع يبقى على آخر نسخة نجحت.
- إذا الموقع موقعك: المشكلة في الحزم داخل منتجك. اقرأ الرسالة من فوق: سطر Found يقول نسختك، وسطر peer ... from يقول مين الحزمة اللي تبي نسخة ثانية.
علامة سريعة: إذا يمشي عندك ويفشل في النشر، غالبًا ملف package-lock.json مو مرفوع مع الكود، أو ثبّتت عندك مرة بـ --force ونسيت.
إيش تكتب لـ Lovable أو Bolt أو Cursor
أداة الذكاء الاصطناعي غالبًا تقترح --force أو --legacy-peer-deps. البناء ينجح، لكن الحزمة ممكن تتعطّل وقت التشغيل عند مستخدم معيّن، وأي تعارض جديد بعدين ما راح تشوفه. انسخ سطري Found و peer من الرسالة، وبعدها هذا:
Install/deploy fails with npm ERESOLVE.
Found: <paste the Found line>. Could not resolve: <paste the peer ... from ... line>.
Tell me if this package is actually used. Then, in this order: upgrade it to a version
that supports my React/Next.js version, replace it, or remove it.
Do not use --force or --legacy-peer-deps and do not delete package-lock.json.
Commit package-lock.json with the change.الحل خطوة بخطوة
كيف تعرف أي حزمة سبّبت التعارض، والحلول الثلاثة بالترتيب، وليش يمشي عندك ويفشل في النشر، في درس npm ERR! code ERESOLVE: تعارض الحزم وكيف تحله صح. وإذا البناء يفشل لسبب ثاني، شوف Command "npm run build" exited with 1.
وإذا الخطأ يرجع مع كل حزمة جديدة، هذا علامة إن الأساس محتاج ترتيب، وهذا اللي يسويه حل مشاكل تطبيقك.