«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» en el Mac
UNABLE_TO_GET_ISSUER_CERT_LOCALLY significa que Node.js no encuentra la autoridad que firmó un certificado. La causa habitual es un proxy que inspecciona TLS o una autoridad privada.
Mi Mac tiene este problema: «UNABLE_TO_GET_ISSUER_CERT_LOCALLY» en el Mac. Lee https://kilobat.app/es/guides/npm-unable-to-get-issuer-cert-locally.md y resuélvelo conmigo. Instala la CLI de Kilobat si falta: brew install seifip/kilobat/kilobat. Ejecuta tú mismo las comprobaciones de Terminal y de kilobat de la guía y dime qué encuentras. Enumera los pasos que solo yo puedo hacer. Pregunta antes de cambiar cualquier ajuste.
Síntomas
- Una herramienta de Node.js se detiene con
UNABLE_TO_GET_ISSUER_CERT_LOCALLY. - El mensaje puede decir
unable to get local issuer certificate. - Los navegadores pueden abrir el mismo sitio.
Causas probables
- Un proxy que inspecciona TLS. Un proxy de trabajo firma el tráfico con su propio certificado. Consulta Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac.
- Una autoridad privada. Un registro o una pasarela de empresa usa un certificado de una autoridad que Node.js no conoce.
- Una app de seguridad que analiza HTTPS. Añade su propia raíz, que Node.js no usa de forma predeterminada.
- Falta un intermedio. Un servidor puede omitir parte de su cadena de certificados.
Cómo comprobarlo
Lee el emisor.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerMuestra el archivo de CA que usa npm.
npm config get cafileMuestra la variable de CA de Node.js.
echo $NODE_EXTRA_CA_CERTSPrueba con el punto de acceso del teléfono.
Cómo solucionarlo
Pide al administrador de la red el certificado de CA, en formato PEM.
Indica a Node.js que confíe en él en este shell.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemPara npm, define el mismo archivo.
npm config set cafile /path/to/ca.pemNo definas
NODE_TLS_REJECT_UNAUTHORIZED=0. Desactiva todas las comprobaciones.
Con Kilobat
El doctor de conexión de Kilobat prueba el host capa por capa. La capa TLS muestra un certificado en el que este Mac no confía.
kilobat why https://registry.npmjs.org/Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con
diagnose_connectionydiagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.
Preguntas
¿Por qué funciona el navegador?
macOS confía en los certificados que instala un administrador. Node.js usa su propia lista salvo que añadas un archivo.
¿Definir NODE_TLS_REJECT_UNAUTHORIZED=0 lo soluciona?
No. Desactiva la validación de certificados en todas las conexiones. Añade la CA en su lugar.
Fuentes
Comprobado el 29 de octubre de 2026.