رسائل الأخطاء

«npm error code ECONNRESET» على Mac

يشير ECONNRESET إلى إعادة ضبط الاتصال قسرًا. وهو لا يحدد مصدر إعادة الضبط. تصفه وثائق Node.js بأنه «أعاد الطرف المقابل ضبط الاتصال».

ينطبق على: يعرض npm 10 والإصدارات الأحدث «npm error». تعرض الإصدارات الأقدم «npm ERR!». جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

وكيل أو مرشح يعيد تعيين الاتصالات. قد يغلق وكيل الشركة أو برنامج الأمان الاتصالات التي لا يسمح بها.
فحص TLS. قد يعطّل وكيل يفحص الحركة الآمنة الاتصال. راجع شهادات وكيل الشركة تعطّل أدوات Terminal على Mac.
VPN يعيد الاتصال. تُغلق الاتصالات عبر VPN عند إعادة اتصاله.
اتصال غير مستقر. تقول وثائق Node.js إن انتهاء المهلة أو إعادة تشغيل الطرف البعيد قد يسبب ذلك.

اعرض إعدادات سجل npm والوكيل.

npm config get registry
npm config get proxy
npm config get https-proxy

اطلب استجابة من السجل.
```
npm ping
```
اختبر السجل باستخدام curl. ابحث عن مُصدر الشهادة.
```
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
```
جرّب التثبيت على شبكة أخرى، مثل نقطة اتصال هاتف.

إذا كانت الشبكة تحتاج إلى وكيل، فعيّنه لـ npm.
```
npm config set https-proxy http://proxy.example.com:8080
```
إذا كان وكيل الشركة يفحص TLS، فأضف شهادته الجذرية إلى Node.js. راجع شهادات وكيل الشركة تعطّل أدوات Terminal على Mac.
زد عدد محاولات npm.
```
npm config set fetch-retries 5
```
إذا كانت VPN أو وكيل أو تطبيق أمان قيد التشغيل، فأوقفه لاختبار قصير. أعد تشغيله بعد الاختبار.

يختبر طبيب الاتصال في Kilobat السجل طبقةً بطبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم. ويحدد الطبقة التي فشلت.
```
kilobat why https://registry.npmjs.org/
```
فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام diagnose_connection وdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.

هل ECONNRESET خطأ في مشروعي؟

عادةً لا. أُغلق الاتصال بالسجل. شغّل التثبيت نفسه على شبكة أخرى للمقارنة.

هل ECONNRESET هو نفسه انتهاء المهلة؟

لا. يشير ECONNRESET إلى إعادة ضبط الاتصال. أما انتهاء المهلة فيعني أن العملية لم تكتمل في الوقت المحدد.

تم التحقق في 29 أكتوبر 2026.