Messages d’erreur

« npm error code ECONNRESET » sur Mac

ECONNRESET signifie que l’autre côté a fermé la connexion de force. La documentation de Node.js l’appelle « Connection reset by peer ».

S’applique à : npm 10 et versions ultérieures affichent « npm error ». Les versions plus anciennes affichent « npm ERR! ». Toutes les versions actuelles de macOS.Vérifié le 29 octobre 2026

Symptômes

npm install s’arrête avec npm error code ECONNRESET.
npm ajoute qu’il s’agit d’un problème lié à la connectivité réseau.
Cela arrive sur un réseau d’entreprise, avec un VPN ou avec une app de sécurité.

Causes probables

Un proxy ou un filtre qui réinitialise les connexions. Un proxy d’entreprise ou un logiciel de sécurité peut fermer les connexions qu’il n’autorise pas.
L’inspection TLS. Un proxy qui inspecte le trafic sécurisé peut casser la connexion. Voir Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac.
Un VPN qui se reconnecte. Les connexions qui passent par le VPN se ferment quand il se reconnecte.
Une connexion instable. Selon la documentation de Node.js, un délai dépassé ou un redémarrage côté distant peut en être la cause.

Comment vérifier

Affichez les réglages de registre et de proxy de npm.

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

Demandez une réponse au registre.
```
npm ping
```

Testez le registre avec curl. Cherchez l’émetteur du certificat.

curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer

Essayez l’installation sur un autre réseau, par exemple le partage de connexion d’un téléphone.

Comment corriger

Si le réseau nécessite un proxy, configurez-le pour npm.
```
npm config set https-proxy http://proxy.example.com:8080
```
Si un proxy d’entreprise inspecte le TLS, ajoutez son certificat racine pour Node.js. Voir Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac.
Accordez plus de tentatives à npm.
```
npm config set fetch-retries 5
```
Si un VPN, un proxy ou une app de sécurité est activé, désactivez-le pour un court test. Réactivez-le ensuite.

Avec Kilobat

Le diagnostic de connexion de Kilobat teste le registre couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il indique la couche qui a échoué.
```
kilobat why https://registry.npmjs.org/
```
Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec diagnose_connection et diagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.

Questions

ECONNRESET est-il un bug de mon projet ?

En général, non. La connexion au registre s’est fermée. Lancez la même installation sur un autre réseau pour comparer.

Sources

Documentation Node.js : Common system errors
intro(2), ECONNRESET, page man installée avec macOS 27.2
Documentation npm : config
curl(1), page man installée avec macOS 27.2

Sources vérifiées le 29 octobre 2026. Les pages man sont celles installées avec macOS ; ouvrez-en une avec man <name> dans Terminal.