Comment réparer votre site WordPress qui ne fonctionne pas après une migration

TL;DR : Pressé ? Voici comment faire étape par étape :

• Videz votre cache et le cache côté serveur
• Régénérez votre fichier .htaccess
• Définissez les dossiers sur 755, les fichiers sur 644
• Mettez à jour les anciennes URL dans votre base de données
• Désactivez les plugins pour isoler les conflits
• Contactez votre hébergeur si rien ne fonctionne

Vous venez de terminer la migration de votre site WordPress, et maintenant quelque chose est cassé.

Peut-être s'agit-il d'une erreur 500, d'une impossibilité de connexion à la base de données, ou les visiteurs continuent d'atterrir sur votre ancien domaine au lieu du nouveau.

Aucune de ces situations ne signifie que la migration a complètement échoué. Ce sont des problèmes spécifiques et réparables qui apparaissent juste après un transfert, presque toujours causés par les mêmes quelques éléments : des références de base de données restantes à votre ancienne URL, un fichier .htaccess corrompu, des permissions de fichiers incorrectes ou un plugin qui n'a pas survécu au transfert.

Je vais vous guider à travers les erreurs post-migration les plus courantes, leurs causes et comment les résoudre exactement.

Si vous êtes spécifiquement bloqué hors de wp-admin, sautez directement à notre guide de dépannage dédié à la connexion. Il couvre ce cas plus en profondeur que nous ne le pouvons ici.

Voici les points clés à retenir :

• Les problèmes post-migration sont courants et presque toujours réparables. La plupart remontent à une poignée de causes profondes comme des données mises en cache obsolètes, des URL de base de données incorrectes ou des permissions de fichiers corrompues.
• Les problèmes les plus fréquents incluent le contenu manquant, les échecs de connexion, les liens internes brisés, les erreurs SSL et les redirections pointant toujours vers votre ancien domaine.
• Commencez chaque session de dépannage par vider votre cache et régénérer le fichier .htaccess. Ces deux étapes seules résolvent la majorité des erreurs post-migration.
• Les URL de base de données sont la correction la plus négligée : les anciennes références de domaine laissées dans la base de données sont à l'origine de la plupart des liens brisés, des redirections incorrectes et des images manquantes après un transfert.
• La meilleure prévention est une sauvegarde complète avant de migrer et un outil comme Duplicator qui gère les transferts de fichiers, les mises à jour de la base de données et les réécritures d'URL automatiquement.

Table des matières

Problèmes courants après une migration WordPress

Déplacer votre site WordPress vers un service d'hébergement différent peut parfois entraîner des problèmes ennuyeux.

Voici les problèmes post-migration les plus fréquents que vous pourriez rencontrer :

• Le contenu ne s'affiche pas : Images manquantes sur les pages, articles non affichés ou permaliens brisés empêchant un accès correct au contenu
• Problèmes de connexion : Impossible d'accéder à wp-admin en raison de problèmes de mot de passe, d'écrans de connexion vierges ou de conflits de connexion à la base de données
• Plugins de migration WordPress défaillants : Outils de migration qui ne transfèrent pas correctement les fichiers, les bases de données ou ne mettent pas à jour les paramètres de configuration.
• Perte de fichiers : Des thèmes, plugins ou fichiers de contenu importants disparaissent pendant le processus de transfert.
• Temps d'arrêt : Le site devient inaccessible lorsque les redirections pointent vers l'ancien hébergeur ou que les paramètres DNS ne sont pas correctement mis à jour.
• Les URL dans les articles ne fonctionnent pas : Les liens internes des articles de blog pointent toujours vers votre ancien domaine au lieu du nouveau.
• Erreur lors de l’établissement d’une connexion à la base de données : WordPress ne parvient pas à se connecter à la base de données en raison d’identifiants incorrects ou de problèmes de serveur.
• Erreur interne du serveur 500 : Erreurs génériques du serveur causées par des problèmes de permissions de fichiers, des conflits de plugins ou des fichiers .htaccess corrompus.
• Certificat SSL invalide : Certificats de sécurité qui ne fonctionnent plus après avoir changé de domaine ou de fournisseur d’hébergement.
• Redirections vers votre ancien domaine : Les visiteurs sont automatiquement dirigés vers votre site web précédent au lieu du nouvel emplacement.

1. Le contenu ne s'affiche pas

Si votre site WordPress ne fonctionne pas après la migration, vous constaterez peut-être que votre contenu ne s’affiche pas correctement. 

Lorsque vous ouvrez certaines pages, les images peuvent ne pas s’afficher. Même si elles existent dans votre médiathèque, elles n’apparaissent pas sur le front-end. 

Voici quelques raisons pour lesquelles vos images disparaissent après une migration :

• Permaliens incorrects
• URL du site incorrecte
• URL d’images incorrectes
• Conflits de plugins
• Permissions de fichiers incorrectes
• Caractères spéciaux dans les noms d’images

Un autre problème pourrait être que les articles ou les pages ne s’affichent pas. Cela peut être dû à des paramètres de permaliens incorrects. 

Les permaliens sont les liens uniques vers les articles, les catégories et d’autres listes de blog. Lorsqu’ils ne correspondent pas, votre contenu n’apparaît pas correctement.

Voici comment réinitialiser vos permaliens dans WordPress.

2. Problèmes de connexion

Parfois, une migration vous bloque complètement l'accès à wp-admin : un écran de connexion vide, une boucle de redirection ou des identifiants qui cessent soudainement de fonctionner. Cela arrive assez souvent après une migration pour mériter sa propre explication complète plutôt qu'un bref résumé ici.

Lisez le guide de dépannage complet ici : Impossible de se connecter à WordPress après une migration ? 10 solutions qui fonctionnent

3. Plugins de migration WordPress défaillants

Souvent, le succès de votre migration dépend de l’outil que vous utilisez. Le mauvais plugin de migration pourrait ne pas réussir à déplacer correctement tous vos fichiers et tables de base de données. 

Pour configurer votre nouveau site, le plugin de migration devra également mettre à jour votre fichier wp-config.php avec de nouvelles URL. S'il ne fait pas son travail, vous pourriez rencontrer des erreurs de connexion, du contenu manquant et d'autres problèmes. 

Vous aurez besoin d'un outil de migration sur lequel vous pouvez compter. Pour vous aider à trouver le meilleur, voici mes meilleurs plugins WordPress pour les migrations. 

4. Perte de fichiers

Si votre site WordPress ne fonctionne pas après l'avoir déplacé, vous avez peut-être perdu des fichiers. Ceux-ci pourraient contenir des données importantes comme des thèmes, des plugins, ou même du contenu.  

La chose intelligente à faire est de sauvegarder l'intégralité de votre site avant une migration. Utilisez des plugins de sauvegarde comme Duplicator pour une expérience sans tracas. De cette façon, vous aurez un plan de récupération si les choses tournent mal et que vous perdez des fichiers.

Si des fichiers sont manquants et que vous n'avez pas de sauvegarde, ne vous inquiétez pas. Contactez le support de votre hébergeur. Ils pourraient avoir une sauvegarde ou pouvoir vous aider à récupérer les fichiers perdus.

N'oubliez pas que la prévention vaut mieux que le dépannage. Des sauvegardes régulières de votre site web devraient faire partie intégrante de la gestion de votre site. Elles permettent à votre site WordPress de bien fonctionner, surtout après des migrations ratées.

5. Temps d'arrêt

Il est agaçant que votre site WordPress tombe en panne pendant ou après une migration. Cela se produit souvent lorsque votre nouveau site redirige vers votre ancien hébergeur. 

Certains hébergeurs vous fournissent une adresse interne qui peut vous aider à éviter les temps d'arrêt pendant le déménagement. Vous pouvez tester votre contenu à ce nouvel emplacement et ajouter des redirections lorsque tout fonctionne correctement.

Si votre nouvel hébergeur n'en a pas, vous pouvez simplement mettre à jour le fichier hosts sur votre ordinateur. En ajoutant votre nouvelle adresse IP et votre domaine à ce fichier, vous accéderez aux fichiers de votre nouvel hébergeur pendant que les visiteurs verront votre site sur l'ancien hébergeur.

Essentiellement, cela fait croire à votre ordinateur que votre site web a déménagé alors que ce n'est pas le cas. Ensuite, lorsque vous aurez terminé la migration, supprimez cette entrée de votre fichier hosts. Vous n'aurez aucun temps d'arrêt !

Pour voir exactement comment modifier votre fichier hosts, lisez notre tutoriel sur comment déplacer un site WordPress vers un nouvel hébergeur.

6. Les URL dans les articles ne fonctionnent pas

Vous pourriez remarquer que vos liens internes dans les articles de blog ne fonctionnent pas. C'est généralement parce qu'ils sont toujours connectés à votre ancien site. 

Vous pouvez résoudre ce problème en utilisant des requêtes SQL pour mettre à jour votre base de données MySQL. Ou, vous pourriez utiliser un plugin comme Search & Replace Everything pour faciliter le travail.

Mais, si vous utilisez le bon outil, vos URL seront automatiquement mises à jour pendant la migration. Avec Duplicator Pro, vous pouvez entrer votre ancien domaine et le remplacer par le nouveau. 

Duplicator recherchera et remplacera toutes les anciennes URL dans votre base de données, vous n'aurez donc pas à vous soucier des liens brisés. 

7. Erreur d'établissement d'une connexion à la base de données

Une « Erreur d'établissement de la connexion à la base de données » peut apparaître après le déplacement de votre site WordPress. Cela se produit lorsque votre site ne parvient pas à se connecter à sa base de données. 

Généralement, vous pouvez résoudre ce problème en mettant à jour les détails de la base de données dans votre fichier wp-config.php. Recherchez ces lignes et assurez-vous qu'elles correspondent à votre nouvelle base de données :

• DB_NAME
• DB_USER
• DB_PASSWORD
• DB_HOST

Le panneau de contrôle de votre hébergeur (cPanel, hPanel ou similaire) affiche ces valeurs sous vos paramètres de base de données, ou votre hébergeur peut vous les envoyer directement si vous n'êtes pas sûr de l'endroit où chercher.

Si cela ne fonctionne pas, contactez votre nouvel hébergeur web. Vous devrez vérifier que votre serveur est opérationnel. Il pourrait être temporairement hors service. 

Après vous être assuré que la base de données est correctement configurée, vous devrez peut-être la réparer. Ajoutez ce code au fichier wp-config.php :

define ('WP_ALLOW_REPAIR', true);

Ensuite, utilisez l'outil de réparation intégré à WordPress en visitant ce lien :

http://www.yoursite.com/wp-admin/maint/repair.php

Une fois la réparation terminée, supprimez la ligne WP_ALLOW_REPAIR de wp-config.php. La laisser en place maintient repair.php accessible à quiconque connaît l'URL, sans nécessiter de connexion, elle doit donc être retirée une fois que vous avez terminé.

8. Erreur interne du serveur 500

Un problème courant après une migration WordPress est l'erreur interne du serveur 500. Cela peut être l'une des erreurs les plus frustrantes car elle n'indique souvent pas ce qui la cause. 

Parfois, votre hébergeur ne peut pas accéder à tous les fichiers de votre site après le transfert. Vous devrez trouver et mettre à jour les permissions de vos fichiers. 

Alternativement, vous devrez peut-être régénérer votre fichier .htaccess. Nous vous guiderons à travers ce processus plus tard dans l'article. 

Une autre raison de l'erreur interne du serveur 500 est un conflit de plugins. Essayez de les désactiver et de les réactiver un par un pour voir quand l'erreur se reproduit. 

D'autres solutions comprennent l'augmentation de votre limite de mémoire PHP, le passage à un thème WordPress par défaut et le ré-téléchargement des fichiers WordPress principaux (sauvegardez d'abord, au cas où quelque chose aurait été personnalisé). 

9. Certificat SSL invalide

Après avoir déplacé votre site WordPress, vous pourriez avoir un certificat SSL invalide. Cela arrive souvent car les certificats SSL sont directement liés au nom de domaine de votre site web.

Lors de la migration, vous pourriez changer le nom de votre domaine. Cela peut rendre votre certificat SSL invalide.

La façon la plus simple de résoudre ce problème est d'obtenir un nouveau certificat SSL pour votre nouveau domaine. Votre hébergeur peut vous aider à le faire.

10. Redirections vers votre ancien domaine

Après avoir mis à jour le nom de votre domaine, vos visiteurs peuvent toujours être redirigés vers l'ancien. Cela se produit lorsque l'URL de votre site et l'URL de votre page d'accueil sont différentes des valeurs dans votre base de données.

Des redirections incorrectes peuvent également apparaître en raison de problèmes DNS. Assurez-vous que vos enregistrements DNS sont à jour avant de commencer le dépannage. 

Pour vous assurer que votre site est visible, lisez ce guide sur comment vous assurer que votre site WordPress redirige vers son nouveau domaine.

Comment réparer votre site WordPress qui ne fonctionne pas après une migration

Passons en revue quelques étapes de dépannage que vous pouvez effectuer si quelque chose ne va pas après une migration. De cette façon, vous pourrez résoudre tout problème qui survient !

Suivez ces étapes essentielles de dépannage pour remettre votre site en ligne :

• Videz votre cache : Supprimez le contenu mis en cache obsolète des plugins et des caches côté serveur qui peuvent afficher d'anciennes versions du site
• Régénérez le fichier .htaccess : Corrigez les problèmes de permaliens et les erreurs de serveur internes en créant un nouveau fichier de configuration
• Définissez les bonnes permissions de fichiers : Assurez-vous que les répertoires ont les permissions 755 et les fichiers les permissions 644 pour un accès serveur approprié
• Mettez à jour les URL de la base de données : Utilisez des plugins ou des requêtes SQL pour remplacer toutes les anciennes références de domaine dans votre base de données par la nouvelle URL
• Corriger les conflits logiciels : Identifiez les plugins ou thèmes problématiques en les désactivant et en les testant individuellement
• Contacter le support de votre hébergeur : Obtenez une aide professionnelle de votre fournisseur d'hébergement lorsque les problèmes techniques dépassent votre expertise

Videz votre cache

Les plugins de mise en cache et les caches côté serveur peuvent conserver d'anciennes versions du site, provoquant des erreurs ou des problèmes d'affichage du contenu. 

Si vous voyez une erreur après une migration, videz votre cache. Cela aidera à afficher les dernières modifications sur votre site. 

La manière de procéder dépend de votre solution de mise en cache. Certains plugins offrent une option « vider le cache » ou « purger le cache » dans leurs paramètres. 

Votre fournisseur d'hébergement dispose souvent d'une fonctionnalité pour vider le cache côté serveur sur votre tableau de bord d'hébergement. Si vous n'êtes pas sûr, consultez la documentation de votre plugin ou de votre service d'hébergement.

Régénérer le fichier .htaccess

Les problèmes courants tels que les erreurs de serveur internes ou les mauvais réglages des permaliens peuvent être résolus en régénérant votre fichier .htaccess. Ce fichier contrôle la configuration de votre site. 

Pour réinitialiser le fichier .htaccess, ouvrez vos fichiers WordPress avec un gestionnaire de fichiers comme cPanel ou un client File Transfer Protocol (FTP). Trouvez le fichier .htaccess, qui se trouve dans votre répertoire racine (dossier public_html).

Cette méthode suppose un serveur Apache avec un accès aux fichiers de type cPanel. Si vous êtes sur NGINX ou un hébergeur géré comme WP Engine, Kinsta ou Flywheel, .htaccess n'est soit pas utilisé de la même manière, soit pas directement modifiable, contactez le support de votre hébergeur pour la solution équivalente.

Renommez ce fichier en quelque chose comme : .htaccess_old

Maintenant, retournez à votre tableau de bord WordPress. Accédez à Paramètres » Permaliens et ne modifiez rien. Faites défiler jusqu'en bas et cliquez sur Enregistrer les modifications.

Cela régénère automatiquement le fichier .htaccess. 

Définir les bonnes permissions de fichiers

Si votre site nouvellement migré ne fonctionne pas, vous devrez peut-être vérifier les autorisations de vos fichiers. Elles sont essentielles au bon fonctionnement de votre site.

Les répertoires de votre site WordPress doivent avoir les autorisations définies sur 755. Les fichiers doivent être définis sur 644. 

Vous pouvez réinitialiser ces autorisations via SSH ou FTP. En corrigeant les problèmes d'accès aux fichiers, votre site WordPress fonctionnera correctement après une migration.

Mettez à jour l'URL de votre site dans les paramètres WordPress

Avant de toucher directement à la base de données, vérifiez Réglages » Général. Si vous pouvez toujours vous connecter, c'est la solution la plus rapide. Mettez à jour les champs Adresse WordPress (URL) et Adresse du site (URL) avec votre nouveau domaine, puis enregistrez.

Cela seul résout bon nombre des problèmes de redirection et de liens brisés mentionnés ci-dessus, sans nécessiter de SQL ou de plugin.

Si vous êtes bloqué hors de wp-admin et ne pouvez pas accéder aux Paramètres, utilisez plutôt la méthode de base de données ci-dessous.

Mettre à jour les URL de la base de données

Après la migration, vous pourriez rencontrer des URL mal dirigées qui font toujours référence à l'ancien site.

Vous pouvez mettre à jour les URL de la base de données avec un plugin appelé Search & Replace Everything. Il trouve les anciennes URL dans toutes les tables et les met à jour pour vous. Cela aide à corriger la navigation de votre site après la migration.

Si vous êtes à l'aise avec la modification directe de la base de données, envisagez d'exécuter des requêtes SQL. Cette approche directe pourrait aider à mettre à jour toutes les références d'URL efficacement.

N'oubliez pas de toujours créer une sauvegarde avant de manipuler la base de données ! 

Assurez-vous de mettre à jour l'emplacement de votre site dans la table wp_options. Les anciennes références ici peuvent causer des problèmes de redirection. 

De plus, faites attention au fichier wp-config.php. Vous devez le mettre à jour avec les détails de votre nouveau serveur et de votre base de données pour que tout fonctionne correctement.

Corriger les conflits logiciels

Si votre site WordPress cesse de fonctionner après l'avoir déplacé, le problème peut être dû à des conflits logiciels. Cela peut se produire lorsque les plugins, les thèmes et le logiciel WordPress de base ne fonctionnent pas bien ensemble.

Pour dépanner, allez dans Extensions, sélectionnez-les toutes avec la case à cocher en haut, choisissez Désactiver dans le menu déroulant Actions groupées, et basculez vers un thème par défaut comme Twenty Twenty-Five.

Si le site fonctionne à nouveau, réactivez vos extensions une par une, en rechargeant le site après chacune d'elles. L'extension qui ramène l'erreur est celle du conflit.

Il est conseillé de garder les plugins, les thèmes et WordPress à jour vers les dernières versions. Ces mises à jour incluent souvent des corrections de bugs et des améliorations de compatibilité.

Assurez-vous de tester toutes les mises à jour sur un site de staging avant de les appliquer à votre site en direct.

Contacter le support de votre hébergeur web

Vous pouvez toujours contacter votre équipe de support d'hébergement Web. Ce sont des professionnels expérimentés qui peuvent vous aider à résoudre la plupart des problèmes de migration. 

Assurez-vous de partager ce qui se passe, y compris les messages d'erreur que vous pouvez voir. Plus vous fournissez d'informations sur votre problème, plus vite ils pourront proposer une solution. 

Comment éviter les problèmes de migration courants

Lorsque vous ne planifiez pas correctement, vous rencontrerez de nombreux problèmes après la migration. Parlons de la façon de rendre le transfert aussi fluide que possible.

Prenez le temps de planifier pour éviter les surprises indésirables. Voici quelques ressources précieuses qui vous aideront à migrer votre site Web avec succès :

• La checklist ultime pour la migration WordPress
• Comment migrer un site Web WordPress vers un nouvel hébergeur
• Comment migrer un site WordPress vers un nouveau domaine

Il existe de nombreux plugins de migration WordPress, mais vous n'en trouverez pas de meilleur que Duplicator Pro. Cet outil rend les migrations simples (et sans erreur), et si vous êtes jamais bloqué hors de wp-admin après une migration, son URL de récupération d'urgence peut restaurer votre site même lorsque vous ne pouvez pas vous connecter du tout.

Tout ce que vous aurez à faire est de créer une sauvegarde complète de votre site d'origine. Ensuite, téléchargez le fichier d'archive de sauvegarde.

Sur le deuxième site, déposez le fichier d'archive sur la page Importer les sauvegardes de Duplicator.

Ensuite, vous obtiendrez un guide de migration étape par étape. Vous pouvez facilement effectuer des tâches telles que l'importation de votre base de données et la mise à jour des URL. Cela vous aide à éviter toute erreur lors du déplacement de votre site. 

FAQ sur les problèmes de migration WordPress

De cassé à de nouveau en ligne

J'espère que votre site WordPress nouvellement migré fonctionne maintenant !

Si vous avez réussi cette fois-ci, mais que la migration a tout de même été une expérience stressante, cela mérite qu'on y prête attention. La plupart des maux de tête post-migration proviennent de transferts précipités ou manuels où les réécritures d'URL et les mises à jour de la base de données sont sautées ou mal effectuées.

Un outil fiable comme Duplicator Pro rend le processus plus prévisible. Les étapes de recherche et remplacement d'URL et d'importation de base de données sont gérées pour vous, vous évitant ainsi des heures de débogage.

Voulez-vous migrer votre site WordPress sans aucune erreur ? Téléchargez Duplicator Pro pour des transferts rapides, fluides et efficaces !

Une fois votre site stable, prenez cinq minutes pour documenter ce qui a cassé et ce qui l'a réparé. Les messages d'erreur spécifiques, le plugin qui a causé un conflit ou le paramètre exact que vous avez dû modifier pourraient avoir beaucoup d'importance si vous deviez migrer à nouveau. Une note rapide dans un document ou même une capture d'écran enregistrée dans un dossier suffit.

Pendant que vous êtes ici, je pense que vous aimerez ces guides WordPress supplémentaires :

• Votre migration de site va échouer (sauf si vous évitez ces erreurs)
• 20 erreurs WordPress les plus courantes (et quelques corrections rapides)
• Comment une agence de conception Web a évité les échecs de migration sur plus de 50 projets
• Le guide complet de la migration de site web SEO
• Comment déplacer un site WordPress en direct vers un environnement local
• Combien coûte la migration d'un site WordPress ?