npm est-il en panne ?

Ce que signifie la disponibilité de npm

npm dispose de plusieurs points d’accès qui peuvent tomber en panne indépendamment les uns des autres. Le site web de npm utilise npmjs.com, tandis que l’installation des packages, la résolution des dépendances et la publication utilisent généralement registry.npmjs.org. Le site web peut se charger alors que les requêtes vers le registre échouent, ou un incident du registre peut affecter les commandes de package sans rendre le site web complètement indisponible.

Pour obtenir la vue la plus large au niveau du service, consultez la page de statut officielle de npm. Faites correspondre chaque incident à l’opération qui échoue — récupération d’un package, authentification, publication, accès au registre/à l’API ou accès au site web — plutôt que de supposer que toutes les fonctions de npm sont affectées.

Une page de statut peut confirmer un problème de plateforme signalé, mais elle ne peut pas diagnostiquer un échec propre à un projet. Le message d’erreur npm exact, le registre configuré, le package concerné et le fait que la même requête fonctionne ou non depuis un autre réseau sont souvent plus utiles pour distinguer un incident npm d’un problème local, lié au compte ou à la connectivité.

Diagnostiquer les problèmes de npm

1. Rechercher un incident npm correspondant

Ouvrez la page de statut officielle de npm et recherchez un incident en cours ou récemment résolu affectant le registre, les téléchargements de packages, l’authentification, la publication ou le site web. Si le problème signalé correspond à l’opération qui échoue, évitez les modifications perturbatrices du projet et réessayez une fois l’incident résolu. Si aucun incident correspondant n’apparaît, un problème régional, réseau, lié au compte ou propre au projet reste possible.

2. Déterminer l’étendue de l’échec

Si les installations ou la résolution des packages échouent dans plusieurs projets, donnez la priorité aux vérifications de l’accès au registre, du DNS, du proxy, du pare-feu et de la configuration npm. Si un seul projet ou package est concerné, examinez sa déclaration de dépendances, son lockfile, le nom du package, sa version et le registre configuré avant de conclure à une panne de npm.

Les échecs de publication et de connexion nécessitent une analyse distincte de celle des téléchargements de packages publics. Examinez l’erreur complète, le compte ou le token utilisé, le registre cible et vérifiez si l’échec concerne un seul package, une organisation ou une opération liée au compte.

3. Distinguer les symptômes réseau et DNS

• Délai d’attente de connexion dépassé : la requête peut être bloquée, mal routée ou ne pas parvenir à recevoir de réponse. Comparez la même opération depuis un autre réseau et vérifiez les règles applicables du pare-feu ou du proxy de l’entreprise.
• Connexion refusée : le point de terminaison configuré, le proxy ou le chemin réseau local peut rejeter la connexion. Vérifiez que npm cible bien le registre attendu, et non un ancien point de terminaison interne ou tiers.
• Erreurs DNS telles que NXDOMAIN : le résolveur ne parvient pas à trouver l’hôte demandé. Comparez le comportement du DNS sur un autre réseau et vérifiez le VPN, le filtrage ainsi que les paramètres du résolveur local.
• Erreurs TLS ou de certificat : examinez l’interception HTTPS, les certificats du proxy, l’heure système et les logiciels de sécurité avant d’envisager une modification de la validation des certificats.

4. Vérifier la configuration et l’authentification npm

Vérifiez le registre et les paramètres du proxy configurés, en particulier après un changement de réseau, l’activation d’un VPN ou l’utilisation d’un registre privé. Pour la connexion, la publication ou l’accès à des packages privés, vérifiez que le compte utilisé dispose des autorisations nécessaires et que les identifiants ou tokens n’ont pas expiré. N’exposez jamais de tokens dans la sortie du terminal, les rapports d’incident ou les demandes d’assistance.

5. Vérifier les échecs limités au navigateur

Si le site web de npm échoue dans un navigateur alors que les commandes npm fonctionnent encore, essayez une fenêtre privée ou un autre navigateur et désactivez temporairement les extensions qui bloquent les scripts ou les cookies. Si le navigateur et les commandes npm échouent tous deux, donnez la priorité à la page de statut et aux vérifications réseau plutôt qu’aux correctifs propres au navigateur.

6. Interpréter les réponses du registre et de l’API

Lorsque registry.npmjs.org est inaccessible alors que le site web fonctionne, analysez séparément le chemin vers le registre et notez le code HTTP ou l’erreur npm exact. Une réponse 5xx peut indiquer un problème côté serveur ou en amont ; une réponse 4xx indique plus souvent une requête non valide, une autorisation manquante, un problème d’authentification, une limite de débit ou un package indisponible. Conservez le nom du package, la commande, l’heure et l’erreur complète lors de l’escalade, mais supprimez les identifiants et les tokens.