إصلاح · Node وnpm والبناء

المنفذ مستخدم (EADDRINUSE)

ما قد تراه

يقول خادم التطوير إن المنفذ 3000 مستخدم
يبدأ الخادم على منفذ مختلف عن المتوقع

السبب الأرجح

برنامج آخر (غالباً نسخة سابقة من خادم التطوير نفسه) يستمع على ذلك المنفذ.

افحص أولاً (نحو دقيقتين)

هل عندك تبويب طرفية آخر يشغّل المشروع نفسه؟ أغلقه بـ Ctrl+C.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور يعرف Node.js وnpm وأدوات البناء ويشرحها لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

المشكلة
المنفذ مستخدم (EADDRINUSE)

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
برنامج آخر (غالباً نسخة سابقة من خادم التطوير نفسه) يستمع على ذلك المنفذ.

نفّذ هذه الخطوات بهذا الترتيب
1. شغّل lsof -i :3000 (برقم منفذي) واعرض أي برنامج يحتل المنفذ.
2. إن كان خادم تطويري القديم فأخبرني كيف أوقفه برقم عمليته. وإن كان غير ذلك فلا توقفه؛ شغّل خادمي على منفذ آخر (مثل npm run dev -- -p 3001).
3. شغّل الخادم من جديد وافتح العنوان الذي يطبعه.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يبدأ الخادم ويعرض المتصفح تطبيقي في العنوان المطبوع.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا توقف عمليات لم تبدأها، ولا تستخدم kill -9 على كل شيء.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

شغّل lsof -i :3000 (برقم منفذي) واعرض أي برنامج يحتل المنفذ.
إن كان خادم تطويري القديم فأخبرني كيف أوقفه برقم عمليته. وإن كان غير ذلك فلا توقفه؛ شغّل خادمي على منفذ آخر (مثل npm run dev -- -p 3001).
شغّل الخادم من جديد وافتح العنوان الذي يطبعه.

لا تفعل هذا

لا تعد تشغيل الحاسوب أولاً: غالباً هي عملية واحدة.
لا توقف عمليات لم تبدأها، ولا تستخدم kill -9 على كل شيء.