Une erreur 500 est une réponse du serveur : l’application a échoué sans dire pourquoi au visiteur. La page blanche ou le message générique n’indiquent ni le fichier, ni l’URL exacte. Pour la trouver, il faut le code HTTP, puis la ligne de journal qui correspond à cette requête.
Séparer les codes avant de chercher la cause
| Code | Sens pratique | Où regarder en premier |
|---|---|---|
| 500 | Exception non gérée (PHP, plugin, base, template). | Journal applicatif et journal PHP, à l’heure de la requête. |
| 502 | La passerelle (Nginx, répartiteur) n’a pas compris le processus derrière (PHP-FPM arrêté ou en erreur). | État de PHP-FPM, journal du proxy. |
| 503 | Service volontairement ou temporairement indisponible. | Page de maintenance, limite de connexions. Voir erreur 503 et maintenance. |
| 504 | Le proxy a attendu trop longtemps. | Requêtes lentes en base, script qui dépasse le délai. |
Traiter un 504 comme un « bug PHP » parce que la page affiche « erreur serveur » fait corriger le mauvais étage. Demandez le code brut.
Obtenir le code, pas la page d’erreur habillée
Depuis une machine qui n’est pas connectée à l’administration :
curl -sI https://exemple.fr/page-concernee
La première ligne HTTP/ est le code. Refaites l’appel sur l’accueil, une fiche, le panier et l’URL de retour paiement : un 500 isolé sur une route ne se voit pas en ouvrant seulement l’accueil.
Répétez deux ou trois fois. Un 500 intermittent (un nœud sur trois, un verrou de base) disparaît si vous ne gardez qu’un essai concluant. L’outil Tester une URL donne le même type de lecture depuis l’extérieur : statut, en-têtes, certificat.
Dans Search Console, Indexation puis Pages, le motif « Erreur de serveur (5xx) » liste des URL que Google a reçues en erreur. C’est une piste, en retard, pas une alerte. Ouvrez une URL exemple et reproduisez-la avec curl.
Lire le journal qui correspond à l’heure
Sur un hébergement PHP courant, cherchez dans cet ordre :
- Le journal du site (Apache
error_log, Nginxerror.log) à la minute ducurl. - Le journal PHP (
php_errorou la ligneerror_logde PHP) : fatal error, mémoire dépassée, classe introuvable. - Le journal de l’application (WooCommerce, Laravel, Symfony) si le serveur web n’a qu’une ligne générique.
La ligne utile cite un fichier et souvent un plugin ou un thème. Un 500 apparu juste après une mise à jour se corrige en désactivant cette extension sur un clone, pas en augmentant la mémoire au hasard.
Une page qui déclenche des dizaines d’appels peut aussi faire tomber le worker PHP. Ce n’est pas le même sujet que le nombre de fichiers chargés par le navigateur, mais un script qui interroge un service externe à chaque hit peut finir en 500 ou en 504 quand ce service ne répond plus. L’API de paiement est un cas à part : erreur de l’API de paiement.
Ne pas s’arrêter au premier correctif
Après le correctif, rejouez curl sans cookie et ouvrez la page en navigation privée. Puis notez l’heure, l’URL et la ligne de journal : c’est la base d’un compte rendu d’incident si la panne a touché des clients.
Un contrôle manuel trouve l’erreur que vous soupçonnez. Il ne voit pas la prochaine, à 3 h, sur une URL que personne de l’équipe n’a ouverte. Pour les pages qui prennent des commandes ou des demandes, une sonde extérieure comme SiteGarde rejoue la requête et signale un 500 sans attendre le message d’un client.
Notez l’URL exacte citée dans le journal, pas seulement le code. Un 500 sur une tâche planifiée ou sur une image générée n’a pas le même impact qu’un 500 sur la page de commande. Après le correctif, retestez les deux : réparer la tâche ne rétablit pas la fiche, et l’inverse non plus.
