Un message d'erreur n'est pas une fatalité : c'est une phrase, et elle désigne presque toujours le responsable. Encore faut-il savoir qui parle — le navigateur, le serveur, ou votre application.
Qui parle
| Qui | À quoi le reconnaître | Ce que cela implique |
|---|---|---|
| Le navigateur | Message dans la langue du navigateur, avec son habillage | La demande n'a pas atteint le serveur, ou pas en entier |
| Le serveur | Un code à trois chiffres, une page sobre | La demande est arrivée ; la réponse est un refus ou un échec |
| Votre application | Le message reprend l'habillage de votre site | Le serveur a bien travaillé ; c'est le site qui a échoué |
Le tableau des codes
| Code | Ce que dit le serveur | Cause la plus fréquente | Ce que vous pouvez faire |
|---|---|---|---|
| 301 / 302 | Ce n'est plus ici, allez là | Une redirection voulue | Rien : ce n'est pas une erreur |
| 401 | Identifiez-vous | Une zone protégée par mot de passe | Vérifier les identifiants |
| 403 | Je refuse | Droits de fichier, ou dossier sans page d'accueil | Vérifier les droits et le fichier d'index |
| 404 | Je n'ai pas cette page | Lien mort, adresse changée, fichier absent | Vérifier l'adresse, puis les liens internes |
| 429 | Trop de demandes | Un robot, un script en boucle, une attaque | Signaler, et regarder qui appelle |
| 500 | Mon application a échoué | Extension, mise à jour, erreur de code | Annuler la dernière modification, lire le journal |
| 502 / 504 | Je n'ai pas eu de réponse à temps | Une page trop longue à construire | Alléger la page, signaler si cela persiste |
| 503 | Je suis indisponible | Maintenance, ou surcharge momentanée | Réessayer, puis signaler si cela dure |
Les messages qui ne portent pas de code
- Page entièrement blanche — l'application s'est interrompue en cachant son erreur. Le journal du site en dit plus en une ligne que la page en une heure.
- « Erreur de connexion à la base de données » — le site ne joint plus sa base : identifiants modifiés dans le fichier de configuration, ou base absente.
- « Serveur introuvable » / « Ce site est inaccessible » — le nom de domaine ne mène nulle part. Rien à voir avec le contenu du site.
- « Votre connexion n'est pas privée » — le certificat manque, ne couvre pas cette adresse, ou l'horloge de votre poste est déréglée.
Le journal d'erreurs
Si votre application tient un journal, il dit en une ligne ce qu'une page blanche cache entièrement : le fichier fautif et le numéro de la ligne. C'est le premier endroit à regarder pour toute erreur 500.
Si vous ne savez pas où le trouver pour votre hébergement, demandez-le nous dans un ticket : nous vous indiquerons le chemin exact pour votre service.
Ne laissez jamais l'affichage des erreurs activé sur un site en ligne. Un message d'erreur détaillé montre au public des chemins de fichiers et parfois des identifiants. Il se lit dans le journal, pas sur la page.
Ce qu'il faut nous transmettre
Le code, l'adresse exacte de la page, l'heure, et la ligne du journal si vous l'avez. Avec ces quatre éléments, un incident se traite en une réponse.