« npm error code ECONNREFUSED » sur Mac
ECONNREFUSED signale une connexion refusée. La documentation de Node.js dit : « No connection could be made because the target machine actively refused it. »
Mon Mac a ce problème : « npm error code ECONNREFUSED » sur Mac. Lis https://kilobat.app/fr/guides/npm-econnrefused.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.
Symptômes
npm installou un script s’arrête avecnpm error code ECONNREFUSED.- La ligne suivante nomme une adresse et un port, comme
127.0.0.1:8080. - Cela suit souvent un réglage de proxy ou de registre.
Causes probables
- Un réglage de proxy qui ne pointe sur rien. Un proxy sur
127.0.0.1ou un autre hôte est défini, mais aucun proxy n’y tourne. - Un registre local éteint. Un miroir ou un cache local est en panne.
- Un service inactif. La documentation de Node.js indique que cela résulte généralement d’un service inactif sur l’hôte distant.
- Un script qui appelle un serveur local. Une étape de test ou de compilation peut appeler un serveur qui n’a pas démarré.
Comment vérifier
Lisez l’adresse et le port dans l’erreur.
Affichez le proxy et le registre de npm.
npm config get proxy npm config get https-proxy npm config get registryTestez ce port.
nc -vz 127.0.0.1 8080Affichez les variables de proxy.
env | grep -i proxy
Comment corriger
Supprimez un réglage de proxy dont vous n’avez pas besoin.
npm config delete proxy npm config delete https-proxyDémarrez le registre ou le serveur local que l’adresse désigne.
Supprimez les variables de proxy incorrectes.
unset https_proxy http_proxyRelancez l’installation.
Questions
ECONNREFUSED est-il identique à ECONNRESET ?
Non. ECONNREFUSED est un refus au départ. ECONNRESET ferme une connexion ouverte. Voir « npm error code ECONNRESET » sur Mac.
Pourquoi nomme-t-il 127.0.0.1 ?
npm a essayé une adresse locale, généralement à cause d’un réglage de proxy ou de registre.
Sources
Vérifié le 29 octobre 2026.