أعطال وكيل npm أثناء تنزيل سكربتات التثبيت
قد تشغّل حزمة npm تنزيلاً منفصلاً أثناء التثبيت. حدّد ذلك البرنامج والمضيف بدلاً من افتراض أن كل طلب يستخدم إعداد وكيل سجل npm.
إذا تجاوز تثبيت npm تنزيل السجل وتوقف داخل سكربت تثبيت، فحدّد برنامج التنزيل الثاني. قد تكون حزمة JavaScript موجودة بالفعل بينما لا يزال ملفها الثنائي الخاص بالمنصة مفقودًا.
- اعثر على صاحب الطلب في السجل. سجّل سكربت دورة الحياة والملف التنفيذي أو مكتبة HTTP واسم المضيف الهدف وأول خطأ. يمكن أن تشغّل الحزمة برنامجًا آخر يكون تنزيله منفصلاً عن نقل سجل npm.
- استخدم واجهة الوكيل التي يدعمها ذلك البرنامج. في مسار resources.js الخاص بـ tfjs-node، تُعدّ بيئة وكيل العملية الفرعية مثالاً ملموسًا. راجع إعدادات التنزيل الموثقة للحزمة وبيئة العملية التي تجري الطلب. لا يفيد متغير الوكيل القياسي إلا إذا قرأه ذلك المستهلك؛ وإضافة متغيرات مشابهة الاسم لا تثبت الدعم.
- اتبع مسار الحزمة الفعلي. قد تختلف خوادم الإصدارات ومخازن الكائنات وأهداف إعادة التوجيه عن السجل. قارن مصادقة الوكيل والوجهات المعتمدة وثقة TLS للطلب الذي فشل.
افعل ذلك قبل مسح ذاكرات التخزين المؤقت: فانتقال السجل من جلب الحزمة إلى تنفيذ دورة الحياة يضيّق العطل بالفعل. الوصول الناجح إلى السجل دليل مقارنة مفيد، لكنه لا يثبت أن البرنامج الثانوي يدعم المسار نفسه أو يستطيع الوصول إلى مضيف حزمته.
قد يؤدي تعطيل سكربتات التثبيت إلى تخطي التنزيل وترك الحزمة غير قابلة للاستخدام. إذا وثّقت الحزمة مسار تثبيت معتمدًا مسبق البناء أو دون اتصال، فجهّز تلك الحزمة عمدًا وتأكد من توفر الملف التنفيذي قبل اعتبار التثبيت مكتملاً.