Ir al contenido
01

Erreur 500 sur admin-ajax.php dans WordPress : la diagnostiquer et la corriger

Une requête vers admin-ajax.php qui renvoie une erreur 500 cache toujours une erreur PHP précise. Voici comment la lire, trouver le plugin en cause et corriger durablement.

Walid Sadfi
5 minutos de lectura
Compartir :

Un bouton qui tourne dans le vide, un panier WooCommerce qui ne se met plus à jour, un éditeur Elementor qui refuse d’enregistrer : dans la console du navigateur, on retrouve souvent la même ligne, une requête POST vers /wp-admin/admin-ajax.php qui répond 500. Ce code ne dit qu’une chose : PHP a planté pendant le traitement de la requête. La bonne nouvelle, c’est que la cause exacte est presque toujours écrite quelque part. Il suffit de savoir où la lire.

Ce que fait admin-ajax.php

admin-ajax.php est le point d’entrée AJAX historique de WordPress. Les plugins et les thèmes y envoient des requêtes avec un paramètre action, et WordPress exécute la fonction branchée sur ce nom d’action. Le fichier lui-même est rarement en cause : l’erreur vient de la fonction appelée derrière, donc d’un plugin, du thème ou d’une limite du serveur.

Étape 1 : lire le vrai message d’erreur

Ne désactivez rien au hasard avant d’avoir lu l’erreur. Activez le journal de débogage de WordPress en ajoutant ces lignes dans wp-config.php, au-dessus de la ligne qui indique de ne plus rien modifier :

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

Reproduisez le problème, puis ouvrez le fichier wp-content/debug.log. La dernière ligne Fatal error indique le fichier et la ligne qui ont planté. Si le fichier reste vide, regardez le journal d’erreurs PHP de votre hébergement, et dans les outils de développement du navigateur, l’onglet Réseau puis la réponse de la requête admin-ajax.php : elle contient parfois le message complet.

Étape 2 : identifier l’action et le plugin

Dans l’onglet Réseau, cliquez sur la requête en erreur et regardez son contenu : le paramètre action porte souvent le préfixe du plugin, par exemple woocommerce_, elementor_ ou wpforms_. Croisé avec le chemin du fichier dans le journal, vous savez qui est en cause sans désactiver tout le site.

Les causes les plus fréquentes et leur correction

Une erreur fatale dans un plugin

C’est le cas le plus courant, souvent après une mise à jour de PHP : un plugin ancien appelle une fonction supprimée en PHP 8. Mettez à jour le plugin, ou testez la version précédente. Pour vérifier sans toucher aux visiteurs, le plugin Health Check & Troubleshooting désactive les plugins pour votre seule session. Avec un accès en ligne de commande, WP-CLI permet d’isoler le coupable sur une préproduction :

wp plugin list --status=active
wp plugin deactivate nom-du-plugin
wp plugin activate nom-du-plugin

La mémoire PHP épuisée

Le journal affiche Allowed memory size exhausted. Les requêtes admin-ajax.php passent par l’administration, qui utilise sa propre limite. Relevez les deux dans wp-config.php, dans la limite de ce que votre hébergement autorise :

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

Si la mémoire repart à la hausse quelques semaines plus tard, le vrai problème est ailleurs : une requête qui charge trop de données ou une boucle mal écrite. Augmenter la limite ne fait que gagner du temps.

Le temps d’exécution dépassé

Une action AJAX qui appelle un service externe lent ou traite un gros import peut dépasser max_execution_time. Le correctif durable consiste à découper le traitement en lots, ou à donner un délai maximal aux appels externes pour qu’un service tiers en panne ne bloque pas votre site.

Le Heartbeat qui surcharge le serveur

L’API Heartbeat envoie une requête admin-ajax.php toutes les 15 à 60 secondes depuis chaque onglet d’administration ouvert. Sur un hébergement modeste, plusieurs éditeurs connectés suffisent à provoquer des erreurs 500 intermittentes. Espacer ces requêtes soulage le serveur sans rien casser :

add_filter( 'heartbeat_settings', function ( $settings ) {
    $settings['interval'] = 60;
    return $settings;
} );

Erreur 500, 400 ou 403 : ne pas confondre

  • Une erreur 400 avec la réponse 0 signifie que l’action n’est enregistrée par aucun plugin : un plugin désactivé ou un hook mal écrit.
  • Une erreur 403 vient en général d’un pare-feu ou d’un jeton de sécurité (nonce) expiré, pas de PHP.
  • Une erreur 500 signifie que PHP a planté : la réponse se trouve dans les journaux.

Éviter que l’erreur revienne

Testez les mises à jour de plugins et de PHP sur une préproduction avant la production, gardez un journal d’erreurs actif, et surveillez les requêtes admin-ajax.php lentes. Remettez WP_DEBUG à false une fois le problème réglé. Si vous préférez déléguer, notre service de maintenance WordPress surveille ces erreurs et intervient avant que vos visiteurs ne les voient.

Questions fréquentes

Peut-on supprimer ou bloquer admin-ajax.php ?

Non. De nombreux plugins, WooCommerce en tête, en dépendent. Le bloquer casse des fonctions du site, souvent sans message clair.

L’erreur n’apparaît que pour les visiteurs déconnectés, pourquoi ?

Les actions publiques passent par le hook wp_ajax_nopriv_. Si seul ce hook plante, c’est souvent un cache de page qui sert un jeton de sécurité périmé, ou un plugin qui suppose un utilisateur connecté.

Besoin d’un développeur pour régler le problème ou éviter qu’il revienne ? Découvrez notre service de maintenance WordPress.

Autor

Walid Sadfi

Walid Sadfi est le fondateur d'Evolurise, une équipe d'ingénieurs déployés chez ses clients : développement sur mesure (WordPress, Drupal, React, Laravel), agents IA, DevOps et formation des équipes. Fort de 8 ans d'expérience, il accompagne PME et grands comptes, de la compréhension du problème au déploiement de la solution. Il partage sur ce blog des retours de terrain concrets.