“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.

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

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.

Vale para: Node.js, npm e ferramentas baseadas em Node.js, em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

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

  1. Leia o emissor.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. Mostre o arquivo de CA que o npm usa.

    npm config get cafile
  3. Mostre a variável de CA do Node.js.

    echo $NODE_EXTRA_CA_CERTS
  4. Teste com o acesso pessoal de um celular.

Como corrigir

  1. Peça o certificado da CA ao administrador da rede, em formato PEM.

  2. Diga ao Node.js para confiar nele neste shell.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. Para o npm, defina o mesmo arquivo.

    npm config set cafile /path/to/ca.pem
  4. Não defina NODE_TLS_REJECT_UNAUTHORIZED=0. Isso desativa todas as verificações.

Com o Kilobat

  1. 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/
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_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.