Erreur 500 sur WordPress : la méthode de diagnostic en cinq minutes

Q: Comment puis-je corriger un bug WordPress ?

La première action est d'activer le mode debug (WP_DEBUG) pour lire le message d'erreur complet dans wp-content/debug.log. Ce message indique le fichier et la ligne responsables. Les causes les plus courantes (extension incompatible, thème défectueux, .htaccess corrompu) se corrigent sans toucher au code, par simple renommage de fichiers via FTP. Pour les modifications plus profondes, une sauvegarde complète avant intervention reste indispensable.

Un écran d'erreur serveur sur un site WordPress, point de départ du diagnostic

À la une

L’erreur 500 sur WordPress signifie que le serveur n’a pas réussi à traiter la requête, sans préciser pourquoi : c’est une réponse générique du protocole HTTP, définie par la spécification HTTP comme « Internal Server Error ». En activant le journal d’erreurs PHP et en procédant par élimination (extensions, thème, fichier .htaccess), la cause se localise en moins de cinq minutes dans la grande majorité des cas.

Sommaire

Ce que le code 500 indique réellement au navigateur
Activer le log PHP : la seule façon de lire le vrai message d’erreur
Désactiver toutes les extensions d’un coup via FTP ou le gestionnaire de fichiers
Thème par défaut et fichier .htaccess : les deux autres suspects fréquents
Limite mémoire PHP et version du serveur : vérifier la configuration
FAQ

Ce que le code 500 indique réellement au navigateur

Le code de statut HTTP 500 est une réponse du serveur, pas de WordPress lui-même. Il apparaît quand le serveur web (Apache, Nginx, LiteSpeed) rencontre une condition inattendue qui l’empêche de terminer l’exécution du script PHP. Le navigateur ne reçoit alors aucun détail sur la panne : la page affiche un message blanc, un écran « Internal Server Error » ou, sur certains hébergeurs, une page personnalisée d’erreur.

Concrètement, le problème se situe côté serveur. La connexion internet du visiteur n’est pas en cause, le cache du navigateur non plus. Recharger la page ne résout rien tant que la cause persiste. La vraie information se trouve dans le fichier de log du serveur, pas sur l’écran.

Activer le log PHP : la seule façon de lire le vrai message d’erreur

WordPress masque par défaut les erreurs PHP pour ne pas les exposer aux visiteurs. Il faut donc les réactiver temporairement pour obtenir le message précis. Deux constantes dans le fichier wp-config.php suffisent :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

WP_DEBUG_LOG enregistre les erreurs dans le fichier wp-content/debug.log. WP_DEBUG_DISPLAY réglé sur false empêche l’affichage public des messages. Une fois ces lignes ajoutées, il suffit de recharger la page qui provoque l’erreur 500, puis d’ouvrir debug.log via FTP ou le gestionnaire de fichiers de l’hébergeur. Le message indique le fichier PHP fautif, le numéro de ligne et le type d’erreur (fatal error, syntax error, memory exhaustion). L’article sur les réglages utiles de wp-config.php détaille d’autres constantes qui facilitent la maintenance.

Autant le dire, cette étape est la plus utile de toute la procédure. Sans le log, on tâtonne.

Voir aussi Thème enfant : la précaution qui évite de perdre ses personnalisations

Désactiver toutes les extensions d’un coup via FTP ou le gestionnaire de fichiers

Si l’erreur 500 empêche l’accès au tableau de bord (/wp-admin), impossible de désactiver les extensions depuis l’interface. La méthode consiste à renommer le dossier wp-content/plugins en wp-content/plugins_off via un client FTP (FileZilla, Cyberduck) ou le gestionnaire de fichiers proposé par l’hébergeur. WordPress détecte l’absence du dossier et désactive automatiquement toutes les extensions.

Le site redevient accessible ? L’une des extensions est responsable. Il faut alors renommer le dossier en plugins, puis renommer individuellement chaque sous-dossier d’extension pour les réactiver une par une. Celle qui déclenche le retour de l’erreur 500 est la coupable.

Les conflits d’extensions sont la première cause d’erreur 500 sur WordPress, en particulier après une mise à jour. Un article dédié sur ce site aborde la question du nombre d’extensions et de leur qualité. Quand une extension n’est plus maintenue par son développeur, le risque d’incompatibilité augmente avec chaque nouvelle version de PHP ou de WordPress : le sujet est traité dans l’article sur les plugins abandonnés.

Étape	Action	Résultat attendu
1	Renommer `plugins` en `plugins_off`	Si le site revient : une extension est en cause
2	Renommer `plugins_off` en `plugins`	Prépare la réactivation individuelle
3	Renommer chaque sous-dossier d’extension un par un	Identifier l’extension fautive par élimination
4	Supprimer ou remplacer l’extension identifiée	Résolution définitive

Thème par défaut et fichier .htaccess : les deux autres suspects fréquents

Si la désactivation des extensions ne change rien, le thème actif peut être en cause. La méthode est identique : renommer via FTP le dossier du thème actif dans wp-content/themes/. WordPress bascule alors sur le thème par défaut (Twenty Twenty-Four ou Twenty Twenty-Five selon la version installée). Un retour à la normale confirme que le thème contient un code incompatible. Avant toute modification de thème, la précaution de base reste de travailler avec un thème enfant.

Le fichier .htaccess, situé à la racine du site, est l’autre suspect classique. Une règle de réécriture mal formée ou un conflit entre deux directives provoque immédiatement une erreur 500 sur Apache. Pour tester, il suffit de renommer le fichier en .htaccess_old. Si le site fonctionne à nouveau, il faut régénérer un .htaccess propre en allant dans Réglages > Permaliens et en cliquant sur « Enregistrer les modifications » sans rien changer.

La documentation officielle du serveur Apache détaille la syntaxe attendue pour les fichiers .htaccess et les erreurs courantes de configuration.

Limite mémoire PHP et version du serveur : vérifier la configuration

Une erreur du type Fatal error: Allowed memory size of XXX bytes exhausted dans le fichier debug.log indique que PHP manque de mémoire pour exécuter le script. La limite par défaut sur beaucoup d’hébergements mutualisés se situe autour de 128 Mo. WordPress lui-même recommande un minimum de 256 Mo pour un fonctionnement correct avec des extensions courantes.

Pour augmenter cette limite, ajouter dans wp-config.php :

define( 'WP_MEMORY_LIMIT', '256M' );

Cette constante ne fonctionne que si l’hébergeur autorise la valeur demandée. Sur un hébergement mutualisé, la limite maximale est souvent fixée dans la configuration du serveur et ne peut pas être dépassée par le site. Il faut dans ce cas contacter le support de l’hébergeur ou passer à une offre supérieure.

La version de PHP joue aussi un rôle. Un site qui fonctionnait sous PHP 7.4 peut déclencher des erreurs 500 après un passage en PHP 8.2 si des extensions utilisent des fonctions dépréciées ou supprimées. Le panneau de contrôle de l’hébergeur (cPanel, Plesk, ou l’interface propriétaire) permet de vérifier et de modifier la version PHP active. Pour valider ces changements sans risque, un environnement de préproduction reste la méthode la plus sûre.

La maintenance de la base de données (révisions accumulées, transients expirés, tables orphelines) peut aussi contribuer à des dépassements de mémoire sur les requêtes lourdes.

À retenir

Activer WP_DEBUG_LOG dans wp-config.php pour obtenir le message d’erreur exact avant toute autre manipulation.
Renommer le dossier plugins via FTP pour tester un conflit d’extension quand le tableau de bord est inaccessible.
Tester le thème par défaut et renommer le .htaccess si les extensions ne sont pas en cause.
Vérifier la limite mémoire PHP et la version de PHP dans le panneau de l’hébergeur.
Désactiver WP_DEBUG une fois le problème résolu pour ne pas exposer d’informations techniques.

Questions fréquentes

Que signifie l’erreur 500 sur un site web ?

L’erreur 500 (Internal Server Error) signifie que le serveur a rencontré un problème interne qui l’empêche de répondre à la requête. Ce n’est pas un problème de connexion ni de navigateur : c’est le serveur qui échoue à exécuter le script demandé, sans fournir de détail au visiteur.

Comment réparer une erreur 500 ?

La réparation passe par l’identification de la cause via le fichier de log PHP (debug.log), puis par élimination : désactivation des extensions, passage au thème par défaut, remplacement du fichier .htaccess, vérification de la mémoire PHP et de la version du serveur. Chaque étape prend moins d’une minute.

Comment puis-je corriger un bug WordPress ?

La première action est d’activer le mode debug (WP_DEBUG) pour lire le message d’erreur complet dans wp-content/debug.log. Ce message indique le fichier et la ligne responsables. Les causes les plus courantes (extension incompatible, thème défectueux, .htaccess corrompu) se corrigent sans toucher au code, par simple renommage de fichiers via FTP. Pour les modifications plus profondes, une sauvegarde complète avant intervention reste indispensable.

Damien Roux

Damien Roux est l'hébergement web. de web-city.fr, il partage guides pratiques, comparatifs objectifs et outils gratuits pour choisir le bon hébergeur et créer son site WordPress