Erreur 500 WordPress : diagnostiquer et corriger la panne

Sur les sites que nous reprenons en maintenance, l’origine d’une erreur 500 WordPress se répartit presque toujours entre six causes.

• Un conflit d’extensions ou de thème après une mise à jour, quand une extension appelle une fonction retirée du cœur.
• Une mémoire PHP insuffisante : un import de catalogue WooCommerce dépasse la limite allouée.
• Un fichier .htaccess corrompu, souvent après l’installation d’une extension de cache ou de redirections.
• Un changement de version de PHP imposé par l’hébergeur, qui rend un thème ou un code ancien incompatible.
• Des droits de fichiers incorrects après une restauration ou un transfert par FTP.
• Un fichier du cœur ou une base endommagés, cas plus rare qui impose une restauration.

Une erreur 500 WordPress est un message d’accueil, pas une information. Le détail se trouve dans le journal d’erreurs de l’hébergeur, accessible depuis son panneau ou en SSH : il contient la ligne PHP fatale.

Le second journal est celui de WordPress. En déclarant dans wp-config.php les constantes WP_DEBUG et WP_DEBUG_LOG à vrai et WP_DEBUG_DISPLAY à faux, les erreurs sont écrites dans wp-content/debug.log sans être affichées aux visiteurs : une trace PHP publique exposerait des chemins serveur. Retirez ces constantes une fois le diagnostic terminé.

Nous suivons toujours le même ordre.

1. Sauvegarder fichiers et base avant toute manipulation.
2. Lire les journaux pour obtenir le fichier fautif. Le nom du dossier d’une extension y apparaît souvent et le diagnostic s’arrête là.
3. Vérifier l’administration. Si /wp-admin/ répond encore, la panne vient du thème ou d’une extension active côté public.
4. Neutraliser les suspects en renommant le dossier de l’extension en FTP, ce qui la désactive sans passer par l’interface.
5. Restaurer le .htaccess ou la dernière sauvegarde si rien n’émerge, puis rejouer les mises à jour en préproduction.

Sur un site vitrine, la séquence prend moins d’une heure. Sur une boutique WooCommerce ou une application Symfony, nous travaillons d’abord sur une copie.

Si la trace mentionne un dépassement de mémoire, la limite s’élève en déclarant WP_MEMORY_LIMIT dans wp-config.php, ou côté hébergeur. Passer de 128 à 256 mégaoctets suffit le plus souvent ; si la consommation continue de grimper, la cause réelle est une extension mal optimisée.

Pour un .htaccess suspect : le renommer, recharger le site, puis régénérer un fichier propre en enregistrant à nouveau les permaliens.

Côté PHP, WordPress demande la version 8.1 au minimum et fonctionne mieux en 8.2 ou 8.3. Un site resté sur une version ancienne tombera en erreur 500 WordPress le jour où l’hébergeur coupera la version obsolète : testez la montée de version en préproduction. Les droits, enfin, restent à 755 pour les dossiers et 644 pour les fichiers.

Lorsque les journaux restent muets, il faut isoler. La méthode la plus rapide consiste à renommer le dossier wp-content/plugins : toutes les extensions sont désactivées d’un coup. Si le site revient, on les réactive une par une jusqu’à reproduire l’erreur 500 WordPress. Même logique pour le thème : basculer sur un thème par défaut indique si le problème vient du thème actif ou d’un développement spécifique. Sur nos projets, le code sur mesure est isolé dans une extension maison, ce qui rend ce test possible.

Attention sur une boutique : désactiver toutes les extensions coupe aussi les paiements. Opérez hors affluence, ou sur une copie. Nos interventions de réparation de site WordPress suivent ce principe.

La plupart des pannes que nous traitons étaient évitables. Quatre habitudes suffisent à faire disparaître l’erreur 500 WordPress du quotidien d’une PME.

• Une préproduction qui reçoit les mises à jour avant la production.
• Des sauvegardes automatisées et testées : une sauvegarde jamais restaurée n’est pas une sauvegarde.
• Une supervision qui alerte dès que le site répond un code 500.
• Un parc d’extensions tenu court, à jour, sans extension abandonnée par son auteur.

C’est ce que couvre un contrat de maintenance de site WordPress : mises à jour jouées en préproduction, sauvegardes vérifiées et remise en ligne prise en charge. Voir aussi : migrer son site vers WordPress.