Votre site WordPress a besoin d’aide ? Parlons-en.

Mauvaises URLs après une migration WordPress

Après avoir migré votre site WordPress, les liens, images et ressources pointent encore vers l'ancien domaine : la base de données contient toujours les anciennes URL.

Comprendre le problème

Des mauvaises URLs après une migration WordPress signifient que la base de données contient encore l'ancien domaine. Liens, images et redirections pointent vers la mauvaise adresse. La solution est une recherche-remplacement des URL, en gérant correctement les données sérialisées.

La piste à vérifier

Lancez une recherche-remplacement de l'ancienne URL vers la nouvelle avec un outil qui gère les données sérialisées (WP-CLI search-replace ou Better Search Replace).

Comment reconnaître ce bug

  • Les images et ressources renvoient vers l'ancien domaine
  • Des liens internes mènent à l'ancienne adresse du site
  • Le site redirige vers l'ancien domaine
  • Des réglages de plugins ou de widgets sont cassés après la migration

Qu’est-ce que ce bug ?

WordPress enregistre des URL absolues dans la base de données : adresse du site, liens d'images, contenu d'articles, réglages de plugins. Après une migration vers un nouveau domaine, ces URL pointent toujours vers l'ancien. Il faut les remplacer, en respectant les données sérialisées sous peine de casser des réglages.

Pourquoi ce problème apparaît

URL absolues dans la base de données

L'ancien domaine est enregistré dans le contenu, les réglages et les métadonnées.

Recherche-remplacement non effectuée

Aucun remplacement des URL n'a été fait après la migration.

Données sérialisées corrompues

Un remplacement direct en SQL a brisé la longueur des chaînes sérialisées.

siteurl et home non mis à jour

Les champs de wp_options pointent encore vers l'ancien domaine.

Comment réparer ce bug

Avant de modifier votre site

Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.

  1. Mettre à jour siteurl et home

    Dans phpMyAdmin, corrigez les champs siteurl et home de wp_options avec le nouveau domaine.

  2. Lancer une recherche-remplacement sûre

    Utilisez WP-CLI (wp search-replace 'ancien-domaine' 'nouveau-domaine') ou le plugin Better Search Replace, qui gèrent les données sérialisées.

  3. Éviter le SQL brut

    N'utilisez pas une simple requête UPDATE en SQL : elle casse les données sérialisées en désynchronisant la longueur des chaînes.

  4. Régénérer les permaliens

    Après le remplacement, allez dans Réglages > Permaliens et enregistrez pour reconstruire les règles de réécriture.

Comment éviter qu’il revienne

  • Effectuez systématiquement une recherche-remplacement après une migration
  • Utilisez un outil qui prend en charge les données sérialisées
  • Sauvegardez la base de données avant toute opération de remplacement

Questions fréquentes

Comment corriger les URL après une migration WordPress ?

Mettez à jour siteurl et home dans wp_options, puis lancez une recherche-remplacement de l'ancien domaine vers le nouveau avec WP-CLI ou un plugin gérant les données sérialisées.

Pourquoi ne pas remplacer les URL directement en SQL ?

Parce qu'une requête UPDATE en SQL ne met pas à jour la longueur des chaînes dans les données sérialisées : cela corrompt les réglages de plugins, de widgets et de thème.

Qu'est-ce qu'une donnée sérialisée dans WordPress ?

C'est une chaîne qui encode un tableau ou un objet PHP, avec la longueur de chaque valeur. Un remplacement naïf désynchronise ces longueurs et rend la donnée illisible.

Faut-il aussi corriger les images après une migration ?

Oui. Les URL d'images sont stockées dans le contenu et la médiathèque. La recherche-remplacement les met à jour en même temps que les autres URL du site.