O npm está fora do ar?

O que a disponibilidade do npm significa

O npm tem vários caminhos de acesso que podem falhar de forma independente. O site do npm usa npmjs.com, enquanto a instalação de pacotes, a resolução de dependências e a publicação geralmente envolvem registry.npmjs.org. O site pode carregar enquanto as solicitações ao registro falham, ou um incidente no registro pode afetar os comandos de pacote sem deixar o site completamente offline.

Para obter uma visão mais ampla no nível do serviço, consulte a página oficial de status do npm. Relacione qualquer incidente à operação que está falhando — como obtenção de pacotes, autenticação, publicação, acesso ao registro/API ou acesso ao site — em vez de presumir que todas as funções do npm foram afetadas.

Uma página de status pode confirmar um problema de plataforma já reportado, mas não pode diagnosticar uma falha específica do projeto. O erro exato do npm, o registro configurado, o pacote afetado e o fato de a mesma solicitação funcionar em outra rede costumam ser mais úteis para diferenciar um incidente no npm de um problema local, de conta ou de conectividade.

Solução de problemas do npm

1. Verifique se há um incidente correspondente no npm

Abra a página oficial de status do npm e procure um incidente ativo ou resolvido recentemente que afete o registro, downloads de pacotes, autenticação, publicação ou o site. Se o problema reportado corresponder à operação que está falhando, evite alterações disruptivas no projeto e tente novamente depois que o incidente for resolvido. Se nenhum incidente correspondente aparecer, ainda é possível que exista um problema regional, de rede, de conta ou específico do projeto.

2. Determine o alcance da falha

Se as instalações ou a resolução de pacotes falharem em vários projetos, priorize verificações de acesso ao registro, DNS, proxy, firewall e configuração do npm. Se apenas um projeto ou pacote falhar, examine a declaração de dependência, o lockfile, o nome do pacote, a versão e o registro configurado antes de tratar o problema como uma indisponibilidade do npm.

Falhas de publicação e login exigem uma análise separada dos downloads de pacotes públicos. Revise o erro completo, a conta ou o token usado, o registro de destino e se a falha afeta um pacote, uma organização ou uma operação de conta específica.

3. Diferencie sintomas de rede e DNS

• Connection timed out: a solicitação pode estar bloqueada, sendo roteada incorretamente ou sem conseguir receber uma resposta. Compare a mesma operação em outra rede e verifique as regras aplicáveis de firewall ou proxy corporativo.
• Connection refused: o endpoint configurado, o proxy ou o caminho de rede local pode estar rejeitando a conexão. Confirme se o npm está direcionando a solicitação ao registro esperado, e não a um endpoint interno ou de terceiros desatualizado.
• Erros de DNS como NXDOMAIN: o resolvedor não consegue encontrar o host solicitado. Compare o comportamento do DNS em outra rede e verifique a VPN, os filtros e as configurações do resolvedor local.
• Erros de TLS ou certificado: verifique a interceptação HTTPS, os certificados do proxy, o horário do sistema e os softwares de segurança antes de considerar qualquer alteração na validação de certificados.

4. Revise a configuração e a autenticação do npm

Verifique o registro configurado e as configurações de proxy, especialmente após trocar de rede, ativar uma VPN ou usar um registro privado. Para login, publicação ou acesso a pacotes privados, confirme se a conta pretendida tem a permissão necessária e se as credenciais ou os tokens não expiraram. Nunca exponha tokens na saída do terminal, em relatórios de problemas ou em solicitações de suporte.

5. Verifique falhas exclusivas do navegador

Se o site do npm falhar no navegador enquanto os comandos de pacote continuarem funcionando, tente uma janela privativa ou outro navegador e desative temporariamente extensões que bloqueiam scripts ou cookies. Se tanto o navegador quanto os comandos do npm falharem, priorize a página de status e as verificações de rede, em vez de correções exclusivas do navegador.

6. Interprete as respostas do registro e da API

Quando registry.npmjs.org estiver inacessível enquanto o site funcionar, avalie o caminho do registro separadamente e registre o status HTTP exato ou o erro do npm. Uma resposta 5xx pode indicar um problema no servidor ou em um serviço upstream; uma resposta 4xx geralmente aponta para uma solicitação inválida, permissão ausente, problema de autenticação, limite de requisições ou pacote indisponível. Ao encaminhar o problema, preserve o nome do pacote, o comando, o horário e o erro completo, mas remova credenciais e tokens.