Retour au blog Guide Pratique - 6 min

Comment trouver les erreurs 500 d’un site

Trouver une erreur 500 : la distinguer des autres codes 5xx, la chercher dans les journaux et la confirmer depuis l’extérieur du serveur.

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

CodeSens pratiqueOù regarder en premier
500Exception non gérée (PHP, plugin, base, template).Journal applicatif et journal PHP, à l’heure de la requête.
502La 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.
503Service volontairement ou temporairement indisponible.Page de maintenance, limite de connexions. Voir erreur 503 et maintenance.
504Le 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 :

  1. Le journal du site (Apache error_log, Nginx error.log) à la minute du curl.
  2. Le journal PHP (php_error ou la ligne error_log de PHP) : fatal error, mémoire dépassée, classe introuvable.
  3. 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.

Questions fréquentes

Une erreur 500 est-elle la même chose qu’une 503 ?

Non. Le 500 vient en général d’une exception dans l’application. Le 503 annonce une indisponibilité temporaire, voulue pendant une maintenance ou subie pendant une surcharge. Le correctif et le message à Google ne sont pas les mêmes.

Search Console suffit-il pour trouver les 500 ?

Non. Le rapport Pages signale des erreurs serveur après coup, sur les URL que Google a essayé d’explorer. Il ne voit pas une fiche produit tombée en erreur à 22 h si le robot n’est pas passé.

Le site s’affiche chez moi, pourtant des visiteurs voient un 500. Pourquoi ?

Le cache, une session connectée à l’administration, ou un seul nœud malade derrière un répartiteur. Il faut interroger l’URL publique, sans cookie, plusieurs fois.

Surveiller mes URL