npm è fuori uso? Stato in tempo reale e segnalazioni di guasti

Informazioni sul servizio e risoluzione dei problemi

npm non risponde ai comandi

Quando il client npm smette di rispondere o impiega minuti interi su operazioni semplici, il problema è quasi sempre la cache corrotta o una versione obsoleta. Prima di tutto, esegui npm cache clean --force e riprova. Se non cambia nulla, aggiorna npm stesso con npm install -g npm@latest. Su sistemi Linux e macOS, molti errori di permessi si risolvono correggendo il proprietario della directory globale invece di usare sudo su ogni comando.

Installazione dei pacchetti fallisce sempre

Questo errore si manifesta spesso con messaggi legati a EACCES, ENOENT o timeout di rete. Le cause più comuni:

• la directory node_modules ha permessi errati, correggibili con chown ricorsivo sulla cartella del progetto
• il file package-lock.json è in conflitto con package.json, quindi va eliminato e rigenerato
• il registro predefinito è irraggiungibile, verificabile con npm ping
• la versione di Node.js non è compatibile con i pacchetti richiesti

Errori di autenticazione al registro

Se il login al registro fallisce o il token viene rifiutato, il file .npmrc nella home dell'utente potrebbe contenere credenziali scadute. Cancella la riga con authToken relativa al registro che stai usando e riesegui npm login. Su ambienti CI, assicurati che la variabile d'ambiente con il token sia effettivamente disponibile al momento dell'esecuzione dello script.

Dipendenze non trovate dopo l'installazione

Succede quando il percorso globale di npm non è incluso nel PATH di sistema. Esegui npm root -g per trovare la directory esatta e aggiungila manualmente alla variabile PATH nel file di configurazione della shell. Su Windows, il problema si ripete spesso dopo aggiornamenti di sistema che sovrascrivono le variabili d'ambiente dell'utente.

Il comando npx non esegue i pacchetti

• verifica che npx sia incluso nella versione di npm installata, nelle versioni precedenti alla 5.2 non era presente
• se il pacchetto esiste ma npx dice che non lo trova, prova a specificare la versione esplicitamente
• su reti aziendali con proxy, configura npm con le variabili http_proxy e https_proxy

Aggiornamenti dei pacchetti rompono il progetto

Eseguire npm update senza vincoli di versione può introdurre breaking changes. La pratica più affidabile è usare npm outdated per valutare cosa cambierà prima di aggiornare, e fissare le versioni critiche nel package.json con il prefisso esatto invece di usare il caret o la tilde. Se il danno è già fatto, npm ci reinstalla tutto partendo dal lockfile senza interpretarlo.