Se connecter Commencer

Résoudre les problèmes de Jetpack

Vous avez des difficultés à connecter Jetpack à votre site ou avec une autre fonctionnalité de Jetpack ? Si c’est le cas, voici les étapes recommandées pour résoudre les problèmes courants de Jetpack.

Avant de commencer le dépannage, vérifiez que votre site est accessible publiquement ; Jetpack ne pourra sinon pas s’y connecter ! Vous pouvez en savoir plus sur pourquoi il est nécessaire de connecter votre compte WordPress.com à Jetpack.

Vérifier s’il y a une interruption de service de Jetpack

Y a-t-il une interruption de service de Jetpack ? Consultez https://automatticstatus.com pour connaître l’état actuel du service et les opérations de maintenance programmées. Si tout y fonctionne, le problème est probablement propre à votre site. Poursuivez en exécutant l’outil de débogage de Jetpack.

Si la page d’état indique une interruption ou une opération de maintenance affectant Jetpack, attendez qu’elle soit indiquée comme résolue, puis vérifiez à nouveau votre site.

https://automatticstatus.com est la page d’état officielle de Jetpack.

Exécuter l’outil de débogage de Jetpack

L’outil Jetpack Debug Tool (jptools.wordpress.com/debug/) peut identifier de nombreuses causes différentes des problèmes de connexion. Pour vérifier votre connexion à Jetpack, consultez votre site, copiez l’URL dans la barre d’adresse de votre navigateur et collez-la dans l’outil de débogage de Jetpack. Si votre connexion fonctionne et que tous les tests réussissent, le message « Tout semble fonctionner parfaitement ! » s’affichera.

Si vous obtenez une erreur, essayez de reconnecter Jetpack en suivant précisément ces étapes :

  1. Connectez-vous au tableau de bord WP Admin de votre site et accédez à Jetpack → My Jetpack.
  2. En bas de la page, cliquez sur Site et compte connectés.
  3. Dans la fenêtre modale qui s’affiche, cliquez sur Déconnecter Jetpack.
  4. Suivez les autres instructions jusqu’à la confirmation de la déconnexion.
  5. Accédez à Jetpack → My Jetpack.
  6. Cliquez sur Booster mon site et terminez le processus de connexion.
  7. Utilisez l’outil Jetpack Debug à l’adresse https://jptools.wordpress.com/debug/ pour vérifier à nouveau votre site. Si l’erreur persiste, continuez à rechercher les autres problèmes répertoriés sur cette page.

Messages d’erreur

Un message d’erreur s’affiche lorsque vous essayez de connecter Jetpack ou dans l’outil de débogage de Jetpack ci-dessus ? En voici quelques exemples :

  • Opération expirée
  • Erreur de connexion
  • Erreur cURL 60
  • XML‑RPC ne répond pas correctement

Consultez la page Messages d’erreur pour voir les erreurs les plus courantes, leurs causes et la manière de les résoudre.

Vérifier les problèmes connus

Consultez la Liste des problèmes connus  pour repérer d’éventuels conflits. Si vous utilisez une extension ou un thème qui y figure et que vous ne pouvez pas utiliser d’alternative, Jetpack risque de ne pas fonctionner pour vous.

Vérifiez votre fichier xmlrpc.php

Jetpack a besoin de ce fichier pour se connecter à votre site.

Commencez par vérifier yourjetpack.blog/xmlrpc.php (en remplaçant « yourjetpack.blog » par votre véritable domaine) dans la barre d’adresse de votre navigateur. Cette page doit renvoyer le message suivant : Le serveur XML-RPC n’accepte que les requêtes POST.

Le message affiché doit être exactement identique à celui indiqué ci-dessus, sans espace ni saut de ligne avant ou après, et sans aucun autre texte. Comparez le vôtre avec cet exemple fonctionnel.

  • Si vous voyez ce message, mais qu’il ne se trouve pas seul sur sa ligne, un thème ou une extension affiche peut-être des caractères supplémentaires alors qu’il ne devrait pas. Recherchez les conflits d’extension ou de thème.
  • Si vous obtenez une erreur 404 ou le message « Not Found », contactez votre hébergeur. Des mesures de sécurité peuvent bloquer le fichier XML-RPC, ce qui peut entraîner des problèmes avec Jetpack et d’autres extensions.
  • Le fichier XML-RPC ne se trouve peut-être pas dans le dossier racine de votre installation WordPress, auquel cas Jetpack ne pourra pas se connecter. La réinstallation du cœur de WordPress devrait le remplacer, ou vous pouvez demander à votre hébergeur de le faire.

Les requêtes de WordPress.com vers votre site sont bloquées

Jetpack affiche cet avis lorsque le pare-feu de votre hébergeur, le pare-feu d’application web (WAF) ou une règle de sécurité empêche WordPress.com d’atteindre xmlrpc.php sur votre site :

Les requêtes de WordPress.com vers votre site sont bloquées, généralement par un pare-feu ou une règle de sécurité. Consultez l’état de santé du site pour obtenir plus d’informations et connaître les prochaines étapes.

La notification s’affiche sur toute page de l’admin WP. Elle propose le lien Consulter l’état de santé du site plutôt qu’une option de reconnexion, car se reconnecter ne résout pas une requête bloquée. Vos jetons de connexion restent valides ; les requêtes qui les contiennent sont bloquées avant d’atteindre votre site.

Pour résoudre ce problème :

  1. Accédez à Outils → État de santé du site et consultez les éléments concernant Jetpack dans le rapport pour obtenir un diagnostic complet et connaître les prochaines étapes.
  2. Demandez à votre hébergeur si un pare-feu, un WAF ou une règle du serveur bloque les requêtes vers xmlrpc.php, et demandez-lui d’autoriser les requêtes provenant de WordPress.com.
  3. Si vous utilisez une extension de sécurité, vérifiez si elle bloque xmlrpc.php et ajoutez une exception pour WordPress.com.

Jetpack effectue une nouvelle vérification une fois par jour. L’avis disparaît automatiquement dans la journée environ qui suit la suppression du blocage. Vous n’avez pas besoin de déconnecter ou de reconnecter Jetpack.

Notez que cet avis n’apparaît pas sur les sites hébergés par WordPress.com.

Conflits entre extensions

Parfois, d’autres extensions peuvent entrer en conflit avec Jetpack et l’empêcher de se connecter à WordPress.com.

Pour exclure un conflit entre extensions :

  1. Désactivez toutes les autres extensions et laissez Jetpack active.
  2. Essayez de vous connecter à nouveau.
  3. Si Jetpack se connecte, vous pouvez réactiver vos extensions une par une pour vérifier que tout continue de fonctionner.

Un conflit peut entraîner d’autres problèmes en plus d’empêcher Jetpack de se connecter. Vérifiez donc si autre chose ne fonctionne pas correctement après l’activation de chaque extension. Si vous constatez qu’une extension entre en conflit avec Jetpack, contactez ses développeurs pour savoir s’il existe une solution permettant de la faire fonctionner avec Jetpack.

Problèmes de thème

Si vous rencontrez un problème d’affichage ou si le dépannage de l’extension ne résout rien, installez et activez l’un des thèmes WordPress par défaut, comme Twenty Twenty Two, puis réessayez. Si les fonctionnalités de Jetpack fonctionnent alors normalement, cela signifie probablement qu’un élément de votre autre thème est défectueux ou incompatible ; vous devez contacter les auteurs de ce thème. Pensez à leur indiquer les étapes de dépannage que vous avez déjà essayées.

État de santé

La section État de santé de l’interface d’administration WP (sous Outils → État de santé) fournit des informations essentielles sur la configuration de votre WordPress ainsi que sur tout autre élément susceptible de nécessiter votre attention.

De plus, Jetpack vérifie à nouveau sa connexion à WordPress.com une fois par jour et indique le résultat dans État de santé. Si les requêtes de WordPress.com vers votre site sont bloquées, État de santé affiche le diagnostic complet et les prochaines étapes, et le résultat disparaît dans un délai d’environ un jour après la levée du blocage.

Vérifications de connexion de Jetpack dans État de santé

Jetpack ajoute un ensemble de vérifications de connexion au rapport d’état de santé du site. Elles portent un badge Connexion Jetpack. Les vérifications qui échouent apparaissent en haut de l’onglet État avec une description et une action recommandée. Les vérifications réussies sont regroupées sous Tests réussis en bas de la page.

Pour les consulter :

  1. Accédez à Outils → État de santé dans l’interface d’administration WP.
  2. 2. Ouvrez l’onglet État.
  3. 3. Recherchez les éléments portant le badge Connexion Jetpack.
  4. 4. Développez Tests réussis pour voir les vérifications qui ont abouti.

Ce que signifient les résultats de la connexion Jetpack

Chaque vérification qui échoue affiche un message décrivant le problème et l’étape suivante recommandée. Retrouvez ci-dessous le message que vous voyez dans la liste.

Connexion et jetons

  • Votre site n’est pas connecté à WordPress.com — Jetpack n’a aucune connexion active à WordPress.com. Reconnectez votre site à WordPress.com.
  • Le jeton du site utilisé pour s’authentifier auprès de WordPress.com est manquant., Jeton manquant pour le propriétaire de la connexion., Le jeton du site utilisé pour s’authentifier auprès de WordPress.com n’a pas pu être validé., ou Jetons de connexion Jetpack invalides. — Les jetons utilisés par Jetpack pour s’authentifier auprès de WordPress.com sont manquants ou WordPress.com ne les accepte plus. Les causes courantes sont une migration du site, une restauration de la base de données ou une déconnexion partielle. Reconnectez votre site pour générer de nouveaux jetons.
  • L’utilisateur qui a configuré la connexion Jetpack n’existe plus sur ce site. — Le propriétaire de la connexion (le compte utilisateur qui a connecté Jetpack) a été supprimé. Reconnectez votre site à l’aide d’un compte administrateur actuel.
  • L’utilisateur (nom d’utilisateur) qui a configuré la connexion Jetpack n’est pas administrateur. — Le propriétaire de la connexion a perdu le rôle d’administrateur. Attribuez à nouveau le rôle d’administrateur à cet utilisateur ou reconnectez votre site avec un autre compte administrateur.

Incohérence d’URL

  • Votre URL d’accueil est définie sur …, mais votre connexion Jetpack l’indique comme …, L’URL de votre site est définie sur …, mais votre connexion Jetpack l’indique comme …, ou Une incohérence d’URL a été détectée entre votre site et WordPress.com. — L’adresse du site a changé après la connexion de Jetpack. Cela se produit après un changement de domaine, un passage de HTTP à HTTPS ou lorsqu’une copie de préproduction du site est connectée. Vérifiez que l’adresse WordPress et l’adresse du site sous Réglages → Général sont correctes, puis contactez l’assistance Jetpack.

Requêtes bloquées par votre site

Deux problèmes différents portent le même titre Votre site bloque les requêtes provenant de WordPress.com. Consultez la description sous le titre pour les distinguer. La reconnexion ne résout aucun de ces problèmes.

  • WordPress.com a atteint votre site, mais la requête a été bloquée. (parfois suivi d’un code d’état HTTP, tel que HTTP 403) — Une extension de sécurité, un pare-feu, un pare-feu pour applications web (WAF) ou une règle du serveur a rejeté la requête de WordPress.com vers le fichier xmlrpc.php de votre site. Demandez à votre hébergeur ou à votre fournisseur de sécurité d’ajouter les adresses IP de la connexion Jetpack à la liste d’autorisation.
  • WordPress.com n’a pas pu établir une connexion sécurisée à votre site, car le certificat SSL de votre site n’a pas pu être vérifié. — Votre certificat SSL est arrivé à expiration, est autosigné ou ne contient pas de certificat intermédiaire. Demandez à votre hébergeur de renouveler le certificat ou de compléter sa chaîne de certificats. Consultez la section Certificats SSL ci-dessous pour savoir comment vérifier votre certificat.

Une fois le blocage ou le problème de certificat résolu, ce résultat disparaît dans un délai d’environ un jour.

Configuration du serveur

  • La valeur du port du serveur est inattendue. — Votre serveur indique un port autre que 80 ou 443. Le message comprend une ligne de code, par exemple define( 'JETPACK_SIGNATURE__HTTPS_PORT', 8443 ). Ajoutez cette ligne exacte à votre fichier wp-config.php. Cette vérification est ignorée lorsque l’URL de votre site contient déjà un numéro de port.
  • Les bibliothèques de manipulation XML de PHP ne sont pas disponibles. — L’extension XML de PHP n’est pas installée sur votre serveur. Consultez la section Extension XML de PHP ci-dessous.

Autres échecs de vérification de connexion

  • La vérification de connexion a échoué (parfois suivie d’un code d’erreur ou d’état) — WordPress.com a effectué sa vérification de connexion sur votre site, mais celle-ci a échoué pour une raison non répertoriée ci-dessus. Reconnectez votre site à WordPress.com. Si le résultat réapparaît, contactez l’assistance Jetpack et joignez le message complet.

Vérifications ignorées

Une vérification ignorée n’est pas un échec. Jetpack ignore la vérification de connexion à WordPress.com dans les cas suivants :

  • Votre site est en mode hors ligne ou en mode sans échec.
  • Votre site ne communique pas avec WordPress.com.
  • Une vérification de connexion Jetpack précédente a échoué. Résolvez d’abord ce problème, puis rechargez État de santé.

Les vérifications du propriétaire de la connexion sont ignorées lorsque le site est connecté à WordPress.com sans utilisateur. C’est prévu et aucune correction n’est nécessaire.

Deux résultats ignorés concernent le délai d’attente, et non un problème sur votre site : Le délai de la vérification a expiré, ce qui peut parfois indiquer un échec ou constituer un faux échec. et WordPress.com n’a pas pu terminer la vérification de connexion. Cela est généralement temporaire. Rechargez État de santé ultérieurement. Si le résultat continue d’apparaître, contactez l’assistance Jetpack.

Configurations spécifiques

Vos fichiers wp-config.php et .htaccess

Si vous ou l’une de vos extensions avez ajouté du code aux fichiers.htaccess ou wp-config.php cela peut avoir entraîné une mauvaise configuration. Consultez ces guides pour obtenir davantage d’informations et connaître les paramètres habituels qui vous aideront à rétablir les fichiers dans leur état par défaut : wp-config / htaccess.

Extension PHP-XML

Le PHP de votre site nécessite l’extension XML pour analyser le XML, dont Jetpack a besoin pour communiquer correctement avec votre site. Contactez le service client de votre hébergeur pour vous assurer que l’extension PHP-XML est installée et active sur votre serveur.

API JSON API (API REST API)

Jetpack utilise XML-RPC et l’API JSON API (API REST API) pour communiquer avec votre site. Vérifiez que l’API JSON API est activée sur votre site et que l’authentification est désactivée. Si vous préférez ne pas désactiver l’authentification sur l’API JSON API de votre site, autorisez plutôt les espaces de noms /jetpack/v4/ et /wpcom/v2/ au lieu de cela. Si vous ne savez pas comment procéder, contactez le service client de votre hébergeur pour obtenir de l’aide.

Cloudflare

Si vous utilisez Cloudflare sur votre site, consultez ce guide pour vous assurer que Jetpack et Cloudflare fonctionnent correctement ensemble.

Testez la vitesse de votre site

Votre site doit répondre initialement en moins de 5 secondes pour que la connexion Jetpack fonctionne correctement.

Vous pouvez vérifier la vitesse et les performances globales de votre site à l’aide de divers outils, comme GTmetrix ou WebPageTest, puis contacter votre hébergeur en lui montrant les résultats. Il pourra peut-être ensuite vous aider à améliorer le temps de réponse et de chargement de votre site.

Certificats SSL

Votre certificat SSL garantit que le trafic sur votre site est sûr et sécurisé. Il peut parfois être mal configuré ou avoir expiré, ce qui empêchera Jetpack de s’y connecter. Vous pouvez rechercher les erreurs sur votre certificat SSL avec cet outil Vérificateur SSL et vérifier son état général avec cet outil Test du serveur SSL. Il devrait généralement obtenir la note A ou A+, et vous ne devriez voir aucune erreur.

Les erreurs SSL les plus courantes que votre hébergeur doit corriger sont :

  • Auto-signé : le certificat n’a pas été créé selon les pratiques de sécurité standard et est considéré comme dangereux
  • Certificat de chaîne intermédiaire manquant : certains certificats SSL sont appliqués à votre site en plusieurs parties. Lorsqu’un ou plusieurs certificats manquent dans la chaîne, la sécurité est compromise et incomplète
  • Expiré : comme un domaine, un certificat SSL doit être renouvelé chaque année, faute de quoi il expire. Les renouvellements de certificats ont généralement lieu sans que vous ayez quoi que ce soit à faire, mais les systèmes automatiques de votre hébergeur peuvent parfois ne pas fonctionner

HTTPS

  • Vérifiez que les réglages SITE_URL et HOME_URL sous Réglages → Général de votre interface d’administration WP utilisent https avant votre domaine, plutôt que simplement http (sans le « s »). Les sites qui utilisent uniquement http ne sont pas sécurisés et n’utilisent pas le certificat SSL mentionné ci-dessus : HTTPS charge correctement le certificat et permet à Jetpack de s’y connecter.
  • Assurez-vous également que tout le trafic de votre site est dirigé vers https également. Par exemple, toute requête vers http://yourjetpack.blog doit être automatiquement redirigée vers https://yourjetpack.blog à la place. Votre hébergeur peut vous aider à vérifier que cela se produit comme prévu.
  • Pour obtenir des informations plus détaillées sur le dépannage des problèmes liés à SSL, consultez ce guide.

Erreurs de base de données lors de la synchronisation de Jetpack

Dans certaines configurations, vous pouvez voir l’erreur suivante dans le error_log:

[13-Oct-2025 07:58:53 UTC] WordPress database error Commands out of sync;
you can't run this command now for query SELECT option_value FROM wp_options
WHERE option_name = 'jpsq_sync_checkout' made by shutdown_action_hook, 
do_action('shutdown'), WP_Hook->do_action, WP_Hook->apply_filters, 
Automattic\Jetpack\Sync\Sender->do_sync, 
Automattic\Jetpack\Sync\Dedicated_Sender::spawn_sync, 
Automattic\Jetpack\Sync\Queue->is_locked, Automattic\Jetpack\Sync\Queue-
get_checkout_id [13-Oct-2025 07:58:53 UTC] WordPress database error 
Commands out of sync; you can't run this command now for query SELECT 
COUNT(*) FROM wp_jetpack_sync_queue WHERE queue_id = 'sync' made by 
shutdown_action_hook, do_action('shutdown'), WP_Hook->do_action, WP_Hook->apply_filters, 
Automattic\Jetpack\Sync\Sender->do_sync, 
Automattic\Jetpack\Sync\Dedicated_Sender::spawn_sync, 
Automattic\Jetpack\Sync\Queue->size, 
Automattic\Jetpack\Sync\Queue\Queue_Storage_Table->get_item_count

Si vous voyez ce message, la solution consiste à ajouter un extrait de code PHP personnalisé à votre site :

add_action( 'shutdown', 'wordpress_check_database_connection', 0 );
function wordpress_check_database_connection() {
    global $wpdb;

    $wpdb->check_connection();
}

Nous avons indiqué la procédure à suivre ici :

Mode développeur

Si vous utilisiez le Mode développement, vérifiez votre fichier wp-config.php et assurez-vous que define('JETPACK_DEV_DEBUG', true); n’y figure plus.

Identifiants du serveur pour Jetpack Backup

Si vous rencontrez des problèmes pour ajouter vos identifiants à Jetpack Backup, nous vous recommandons de contacter votre hébergeur et de lui demander de vous fournir ces informations afin que vous puissiez ensuite les saisir correctement dans vos réglages Jetpack :

  • Type d’identifiants (FTP, SFTP, SSH)
  • Adresse du serveur
  • Numéro de port
  • Nom d’utilisateur du serveur
  • Mot de passe du serveur
  • Chemin d’installation complet de WordPress (où WordPress est installé sur votre serveur)

Réinstaller et reconnecter Jetpack

Vous devez parfois réinitialiser complètement la connexion entre votre site et nos services. Vous pouvez suivre ces instructions pour y parvenir.

Contactez votre hébergeur

Ces problèmes doivent être pris en charge par votre hébergeur plutôt que par le support de Jetpack ; ils sont liés au serveur :

  • Certificats SSL
  • Modifications des adresses IP ou des domaines/URL
  • Migration d’un serveur à un autre
  • Le site est indisponible ou ne répond pas
  • Erreurs (500 / 502 / 504 / 403)
  • Ressources du serveur ou utilisation de la mémoire
  • Problèmes liés au DNS
  • Logiciels serveur obsolètes (PHP, MySQL, etc.)
  • Autorisations des fichiers et des dossiers
  • Problèmes qui persistent même après la désinstallation de Jetpack

Still need help?

Please contact support. We’re happy to advise.

In this section