Erreur 500 WordPress : diagnostic et solutions

Vous ouvrez votre site et, à la place de la page attendue, une phrase sèche : « Erreur 500 », « Internal Server Error » ou « Le serveur a rencontré une erreur interne ». Pas de détail, pas de piste, et l'administration est parfois inaccessible elle aussi. Le réflexe est de tout désactiver au hasard, ce qui fait perdre du temps et parfois davantage.

L'erreur 500 est un code générique : le serveur signale que quelque chose a échoué, sans dire quoi. La bonne méthode consiste donc à se demander ce qui a changé juste avant, puis à suivre la piste correspondante. Cet article vous aide à faire ce tri, puis détaille deux causes que les guides classiques traitent trop vite : la base de données et la mise à jour bloquée. Pour les extensions, les thèmes et la mémoire PHP, deux articles existent déjà : l'erreur critique WordPress et l'écran blanc WordPress.

Commencer par une sauvegarde et un relevé

Avant toute manipulation, notez l'heure d'apparition de l'erreur, la dernière action effectuée (installation, mise à jour, changement de réglage, modification chez l'hébergeur) et l'endroit où elle s'affiche : tout le site, ou seulement l'administration. Demandez aussi une sauvegarde récente à votre hébergeur ou faites-en une si vous en avez la possibilité : voir comment sauvegarder son site WordPress correctement. Les journaux d'erreurs de l'espace d'hébergement, quand ils sont disponibles, peuvent indiquer la vraie cause derrière le code 500.

Le fichier .htaccess, en deux minutes

Ce fichier caché, à la racine du site, contient les règles de réécriture des adresses. Une règle invalide provoque une erreur 500 sur tout le site. Connectez-vous en FTP ou depuis le gestionnaire de fichiers de l'hébergeur, renommez .htaccess en .htaccess_old, puis rechargez le site. S'il s'affiche, retournez dans le tableau de bord, ouvrez Réglages, puis Permaliens, et enregistrez sans rien changer : WordPress recrée un fichier propre. Si vos redirections ou règles de sécurité étaient dans l'ancien fichier, reprenez-les une à une plutôt qu'en bloc.

Erreur 500 et base de données

WordPress range vos contenus et vos réglages dans une base de données. Quand elle est inaccessible, WordPress affiche en principe un message dédié (une erreur de connexion à la base). Mais une table abîmée ou un site restauré à moitié peut aussi se traduire par une erreur 500 ou un écran vide. Dans ce cas :

1. Sauvegardez d'abord la base depuis l'espace de votre hébergeur ou phpMyAdmin, avant de la réparer.
2. Vérifiez les identifiants. Dans wp-config.php, le nom de la base, l'utilisateur, le mot de passe et le serveur doivent correspondre à ceux de l'hébergeur : ils changent parfois lors d'une migration ou d'une réinitialisation.
3. Activez le mode de réparation de WordPress. Ajoutez dans wp-config.php la ligne define('WP_ALLOW_REPAIR', true);, puis ouvrez /wp-admin/maint/repair.php sur votre site et lancez « Réparer la base de données ».
4. Retirez la ligne dès que c'est fini. Cette page de réparation n'est protégée par aucun mot de passe : elle ne doit pas rester accessible.
5. Si l'erreur persiste, contactez votre hébergeur ou restaurez la dernière sauvegarde saine. Pour alléger la base ensuite, mais pas pour la réparer, voir nettoyer la base de données WordPress.

Erreur 500 et mise à jour bloquée

Une mise à jour interrompue (onglet fermé, coupure, délai dépassé) laisse parfois WordPress dans un état intermédiaire. Deux traces peuvent rester :

• Le fichier .maintenance : il affiche le message « Indisponible momentanément pour cause de maintenance ». Sa suppression est détaillée dans le mode maintenance de WordPress.
• Le verrou de mise à jour du cœur : pendant une mise à jour, WordPress inscrit une ligne core_updater.lock dans la table des options de la base pour empêcher deux mises à jour simultanées. Elle s'efface seule au bout de 15 minutes ou à la fin de la mise à jour. Si vous restez bloqué sur le message « une autre mise à jour est en cours » au-delà de ce délai, supprimez cette ligne, après sauvegarde, depuis phpMyAdmin ou avec WP-CLI si votre hébergeur le propose.

Ne supprimez jamais ce verrou pendant qu'une mise à jour tourne vraiment : attendez d'abord le délai de 15 minutes. Une fois le blocage levé, relancez la mise à jour depuis Tableau de bord, puis Mises à jour, en suivant la méthode de mise à jour sans rien casser. Si un bouton de réinstallation de la version en cours est proposé, il permet de remplacer les fichiers du cœur sans toucher à vos contenus.