“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac
UNABLE_TO_GET_ISSUER_CERT_LOCALLY significa que o Node.js não encontra a autoridade que assinou um certificado. A causa usual é um proxy que inspeciona TLS ou uma autoridade privada.
Meu Mac está com este problema: “UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac. Leia https://kilobat.app/pt/guides/npm-unable-to-get-issuer-cert-locally.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.
Sintomas
- Uma ferramenta Node.js para com
UNABLE_TO_GET_ISSUER_CERT_LOCALLY. - A mensagem pode dizer
unable to get local issuer certificate. - Os navegadores podem abrir o mesmo site.
Possíveis causas
- Um proxy que inspeciona TLS. Um proxy de trabalho assina o tráfego com um certificado próprio. Veja Certificados de proxy corporativo quebram ferramentas do Terminal no Mac.
- Uma autoridade privada. Um registro ou gateway da empresa usa um certificado de uma autoridade que o Node.js não conhece.
- Um app de segurança que examina HTTPS. Ele adiciona a própria raiz, que o Node.js não usa por padrão.
- Um certificado intermediário ausente. Um servidor pode omitir parte da cadeia de certificados.
Como verificar
Leia o emissor.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerMostre o arquivo de CA que o npm usa.
npm config get cafileMostre a variável de CA do Node.js.
echo $NODE_EXTRA_CA_CERTSTeste com o acesso pessoal de um celular.
Como corrigir
Peça o certificado da CA ao administrador da rede, em formato PEM.
Diga ao Node.js para confiar nele neste shell.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemPara o npm, defina o mesmo arquivo.
npm config set cafile /path/to/ca.pemNão defina
NODE_TLS_REJECT_UNAUTHORIZED=0. Isso desativa todas as verificações.
Com o Kilobat
O diagnóstico de conexão do Kilobat testa o host camada por camada. A camada TLS mostra um certificado em que este Mac não confia.
kilobat why https://registry.npmjs.org/Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_network. Consulte Descubra por que um site ou API não conecta.
Perguntas
Por que o navegador funciona?
O macOS confia em certificados que um administrador instala. O Node.js usa a própria lista, a menos que você adicione um arquivo.
Definir NODE_TLS_REJECT_UNAUTHORIZED=0 resolve?
Não. Isso desativa a validação de certificados para todas as conexões. Adicione a CA.
Fontes
Verificado em 29 de outubro de 2026.