gyp ERR! build error (node-gyp)

كل الأخطاء مجاني
Node.js و npm

gyp ERR! build error (node-gyp)

فشل node-gyp في تصريف إضافة أصلية (C/C++) من المصدر.

ماذا يعني

فشل node-gyp في تصريف إضافة أصلية (C/C++) من المصدر.

السبب المحتمل

سلسلة أدوات بناء مفقودة (Python، make، مصرّف C++، أو Windows Build Tools)، أو إصدار Node غير متوافق.

كيفية إصلاحه

ثبّت متطلبات البناء المسبقة (build-essential + python3 على Linux، أدوات سطر أوامر Xcode على macOS، أو Visual Studio Build Tools على Windows)، ثم امسح الذاكرة المؤقتة وأعد التثبيت. تحقّق أن الإضافة تدعم إصدار Node لديك.

أخطاء Node.js و npm أخرى

Error: Cannot find module 'x' تعذّر على Node تحديد موقع الوحدة التي حاولت استدعاءها بـ require أو import. ERR_MODULE_NOT_FOUND تعذّر تحليل استيراد وحدة ES إلى ملف على القرص. ERR_REQUIRE_ESM استخدمت require() على حزمة تُشحَن كوحدة ES فقط. Error: listen EADDRINUSE: address already in use المنفذ الذي حاول خادمك الارتباط به مشغول بالفعل بعملية أخرى. Error: ENOENT: no such file or directory أشارت عملية على نظام الملفات إلى ملف أو دليل غير موجود. Error: EACCES: permission denied تفتقر العملية إلى صلاحية قراءة أو كتابة أو ربط الملف أو الدليل أو المنفذ المطلوب. Error: connect ECONNREFUSED رُفضت محاولة اتصال بشكل نشط لأنه لا يوجد شيء يستمع على ذلك المضيف والمنفذ. UnhandledPromiseRejectionWarning رُفض وعد (promise) ولم يعالج الخطأ أي .catch() أو try/catch. FATAL ERROR: JavaScript heap out of memory تجاوزت كومة V8 لجافاسكريبت حدّ الذاكرة الخاص بها وأوقف Node العملية. error:0308010C:digital envelope routines::unsupported روتين تشفير/تجزئة قديم (غالبًا في Webpack 4) غير مدعوم من OpenSSL 3 في إصدارات Node الأحدث. npm ERR! code ERESOLVE تعذّر على npm حلّ شجرة التبعيات بسبب متطلبات تبعية نظير (peer dependency) متعارضة. npm ERR! code ELIFECYCLE خرج نص برمجي في دورة حياة npm (مثل build أو test أو خطاف pre/post) برمز غير صفري. npm ERR! code ENOENT (package.json) تعذّر على npm العثور على package.json في الدليل الحالي. npm ERR! 404 Not Found الحزمة أو الإصدار المطلوب لم يُوجَد في سجل npm. npm ERR! code EACCES رُفضت لـ npm صلاحية نظام الملفات، عادة عند الكتابة إلى دليل عام أو ذاكرته المؤقتة. npm WARN unmet peer dependency تعلن حزمة تبعية نظير مفقودة أو عند إصدار غير مُستوفى. npm ERR! code EBADENGINE (unsupported engine) الحزمة المثبَّتة تتطلّب إصدار Node أو npm لا يطابق بيئتك.

حول البحث عن رموز الأخطاء

أداة البحث عن رموز الأخطاء هي دليل قابل للبحث يضم أكثر من 200 رسالة ورمز خطأ شائع موزعة على 12 فئة: رموز حالة HTTP، أخطاء Windows، أخطاء المتصفح والشبكة، JavaScript، Python، PHP، Node.js وnpm، Java، MySQL، Git، أخطاء shell في Linux ورموز البريد الإلكتروني/SMTP. كل مدخل مكتوب بلغة بسيطة لتسهيل استكشاف الأخطاء وإصلاحها بسرعة.

يُشرح كل خطأ في ثلاثة أجزاء: ماذا تعني الرسالة فعلياً، وما هو سببها الشائع، والخطوات العملية لإصلاحها. هذا التنظيم يحوّل نصاً غامضاً مثل ERR_CONNECTION_REFUSED أو 0x80070005 إلى قائمة إجراءات واضحة بدلاً من التخمين.

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

كيفية استخدام البحث عن رموز الأخطاء

  1. اكتب رمز الخطأ أو الرسالة في مربع البحث — مثلاً 404 أو ERR_NAME_NOT_RESOLVED أو 0x80070005.
  2. ضيّق النتائج باستخدام فلتر الفئة (HTTP، Windows، JavaScript، MySQL وغيرها) إذا أعاد البحث عدداً كبيراً من النتائج.
  3. افتح المدخل المطابق لقراءة معناه وسببه المحتمل وكيفية إصلاحه.
  4. استخدم زر النسخ للحصول على الرمز الدقيق لتضمينه في تقرير خلل أو تذكرة دعم.
  5. راجع قسم الأخطاء ذات الصلة لمعرفة أخطاء أخرى من نفس الفئة.

الأسئلة الشائعة

تغطي 12 فئة: رموز حالة HTTP، أخطاء نظام Windows، أخطاء المتصفح والشبكة، JavaScript، Python، PHP، Node.js وnpm، Java، MySQL، Git، أخطاء shell في Linux ورموز رد البريد الإلكتروني/SMTP — أكثر من 200 مدخل بالإجمالي.

ابحث بكلمات أقل. أقصر جزء فريد يعمل بشكل أفضل: الرمز الرقمي وحده ("404"، "0x80070005") أو اسم الثابت ("ERR_NAME_NOT_RESOLVED") بدلاً من الجملة الكاملة التي طبعها نظامك.

نعم. لكل مدخل صفحة تفصيلية مخصصة تشرح المعنى والسبب المحتمل والإصلاح، بالإضافة إلى أخطاء ذات صلة من نفس الفئة. يمكنك حفظها كإشارة مرجعية أو إرسال الرابط مباشرة لزميل أو تذكرة دعم.

تصف الإصلاحات الحل القياسي المتعارف عليه لكل خطأ. مع ذلك، اقرأ قسم السبب المحتمل أولاً — فقد يكون للرمز نفسه عدة مسببات، ومطابقة السبب مع حالتك يوضح لك الإصلاح المناسب.

نعم، إنها مجانية بالكامل. يمكنك البحث وتصفح دليل الفئات وفتح أي عدد تحتاجه من صفحات تفاصيل الأخطاء دون حساب.
شارك هذا
أدوات ذات صلة
منسّق الشيفرة جمّل HTML وCSS وJavaScript — أعد المسافة البادئة وأضف فواصل الأسطر لجعل الشيفرة المفوضة أو المضغوطة مقروءة. مجاني
ضاغط الشيفرة قلّص HTML وCSS وJavaScript — احذف التعليقات والمسافات لجعل الملفات أصغر وتحميلها أسرع. مجاني
منسّق المصفوفات وسّع المصفوفات والكائنات المضمّنة إلى أسطر نظيفة ذات مسافة بادئة، أو اطوِها لتعود مضمّنة — لـ PHP وJavaScript وTypeScript وJSON وPython وRuby وغيرها. مجاني
محرّك التعبيرات النمطية أنشئ التعبيرات النمطية واختبرها وتتبّع أخطاءها مباشرةً في متصفحك — إبراز التطابقات فوريًا، ومجموعات الالتقاط، ومعاينة الاستبدال، وشرح بالإنجليزية البسيطة، وشيفرة جاهزة للصق لأكثر من 15 لغة. مجاني
منشئ تعبيرات Cron أنشئ تعبير cron من نموذج مرئي بسيط — حدّد كل حقل، وشاهد التعبير المباشر والجدول الزمني المقروء وأوقات التشغيل التالية، ثم حلّل أي تعبير وأعده إلى النموذج. مجاني
فك ترميز JWT فكّ ترميز ترويسة JWT وحمولتها (لا يُتحقّق من التوقيع). مجاني
عمليات البحث الشائعة
البحث عن رمز الخطأ قاعدة بيانات رسائل الأخطاء ماذا يعني هذا الخطأ رموز أخطاء windows رموز أخطاء chrome قائمة رموز أخطاء http إصلاح رسالة الخطأ معنى رمز الخطأ
هل تحتاج إلى مساعدة؟
هل واجهت مشكلة في هذه الأداة؟ أخبر فريقنا.
الإبلاغ عن مشكلة

أضف هذه الأداة المجانية إلى موقعك الخاص — انسخ والصق الكود أدناه.