Mensajes de error

«npm error code ECONNRESET» en el Mac

ECONNRESET significa que el otro extremo cerró la conexión a la fuerza. La documentación de Node.js lo llama «Connection reset by peer» (el otro extremo restableció la conexión).

Se aplica a: npm 10 y posterior muestran «npm error». Las versiones anteriores muestran «npm ERR!». Todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

npm install se detiene con npm error code ECONNRESET.
npm añade que es un problema relacionado con la conectividad de red.
Ocurre en una red de empresa, en una VPN o con una app de seguridad.

Causas probables

Un proxy o filtro que restablece las conexiones. Un proxy de empresa o un software de seguridad puede cerrar las conexiones que no permite.
Inspección TLS. Un proxy que inspecciona el tráfico seguro puede romper la conexión. Consulta Los certificados del proxy corporativo rompen las herramientas de Terminal en el Mac.
Una VPN que se reconecta. Las conexiones que pasan por la VPN se cierran cuando se reconecta.
Una conexión inestable. La documentación de Node.js dice que puede deberse a un tiempo de espera agotado o a un reinicio en el otro extremo.

Cómo comprobarlo

Muestra los ajustes de registro y de proxy de npm.

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

Pide una respuesta al registro.
```
npm ping
```

Prueba el registro con curl. Busca el emisor del certificado.

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

Prueba la instalación en otra red, como el punto de acceso de un teléfono.

Cómo solucionarlo

Si la red necesita un proxy, configúralo para npm.

npm config set https-proxy http://proxy.example.com:8080

Si un proxy de empresa inspecciona TLS, añade su certificado raíz para Node.js. Consulta Los certificados del proxy corporativo rompen las herramientas de Terminal en el Mac.
Dale a npm más reintentos.
```
npm config set fetch-retries 5
```
Si hay una VPN, un proxy o una app de seguridad activados, desactívalos para una prueba breve. Vuelve a activarlos después de la prueba.

Con Kilobat

El diagnóstico de conexión de Kilobat prueba el registro capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y el servidor. Indica la capa que falló.
```
kilobat why https://registry.npmjs.org/
```
Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con diagnose_connection y diagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.

Preguntas

¿ECONNRESET es un error de mi proyecto?

Normalmente no. Se cerró la conexión con el registro. Ejecuta la misma instalación en otra red para comparar.

Fuentes

Documentación de Node.js: Common system errors
intro(2), ECONNRESET, página man instalada con macOS 27.2
npm Docs: config
curl(1), página man instalada con macOS 27.2

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con man <name> en Terminal.