WordPress-Migration fehlgeschlagen? Was Sie prüfen und tun sollten

Bei einer WordPress-Migration wird eine Website auf einen neuen Server, zu einem neuen Hosting-Anbieter oder auf eine neue Domain umgezogen. Wenn sie fehlschlägt, kann die Website in einem unangenehmen Zwischenzustand landen: teils auf dem alten Server, teils auf dem neuen, und auf keinem von beiden voll funktionsfähig.

Möglicherweise bemerken Sie, dass:

die neue Website Fehler oder eine leere Seite zeigt
Seiten laden, aber Bilder fehlen
Links oder die Login-Seite Sie zur alten Domain zurückschicken
der Browser eine Warnung „nicht sicher“ anzeigt
manche Besucher die alte Website sehen und andere die neue
der Datenbankimport mit einem Fehler abgebrochen ist
das Dashboard nicht erreichbar ist

Eine fehlgeschlagene Migration kann belastend sein, besonders wenn die Website Teil Ihres Geschäfts ist. Solange die ursprüngliche Website und ein Backup noch existieren, lässt sich die Situation aber fast immer retten.

Die wichtigste Regel ist einfach: Löschen Sie die alte Website nicht, bevor die neue vollständig geprüft ist.

Dieser Leitfaden erklärt, was bei einer Migration meist schiefgeht, was Sie gefahrlos prüfen können, was Sie vermeiden sollten und wann es besser ist, technische Unterstützung anzufragen.

Was bedeutet eine fehlgeschlagene Migration meistens?

Eine WordPress-Website besteht aus zwei Hauptteilen:

den Dateien: WordPress selbst, Themes, Plugins und hochgeladene Medien
der Datenbank: Seiten, Beiträge, Einstellungen, Nutzer, Bestellungen und vieles mehr

Bei einer Migration werden beide Teile an den neuen Ort kopiert, miteinander verbunden, und dann wird die Domain auf den neuen Server verwiesen.

Eine Migration schlägt fehl, wenn einer dieser Schritte unvollständig oder fehlerhaft ist. Zum Beispiel:

einige Dateien wurden nicht kopiert
die Datenbank wurde nur teilweise importiert
die Einstellungen der Website verweisen noch auf die alte Adresse
die Domain verweist noch auf den alten Server
der neue Server ist anders konfiguriert

Die gute Nachricht: Jedes dieser Probleme lässt sich einzeln prüfen.

Was kann schiefgegangen sein?

Die Website ist nur halb migriert

Bei großen Websites kann die Übertragung wegen Zeitüberschreitung abbrechen. Ein Migrations-Plugin oder ein manueller Upload kann ohne klare Fehlermeldung stoppen und einige Dateien oder Datenbanktabellen zurücklassen.

Typische Anzeichen sind fehlende Bilder, fehlende Plugins, ein Theme, das kaputt aussieht, oder Seiten, die es auf der neuen Website nicht gibt.

Links und Bilder verweisen auf die alte Domain

WordPress speichert die Adresse der Website in seinen Einstellungen und im Inhalt: in Links, Bildpfaden und einigen Plugin-Einstellungen. Wenn sich die Domain geändert hat und diese Verweise nicht aktualisiert wurden, lädt die neue Website möglicherweise Bilder vom alten Server oder schickt Besucher dorthin zurück.

Solange die alte Website online ist, scheint alles in Ordnung zu sein, und in dem Moment, in dem sie abgeschaltet wird, funktioniert es nicht mehr.

Warnungen wegen gemischter Inhalte

Wenn die neue Website HTTPS verwendet, aber einige Inhalte noch über HTTP geladen werden, zeigen Browser möglicherweise eine Warnung „nicht sicher“ oder blockieren Teile der Seite. Das passiert oft nach dem Umzug auf eine neue Domain oder wenn während der Migration ein SSL-Zertifikat aktiviert wurde.

DNS hat sich noch nicht verbreitet

Wenn die Domain auf einen neuen Server verwiesen wird, ist die Änderung nicht überall gleichzeitig sichtbar. Eine Zeit lang erreichen manche Besucher den alten Server und andere den neuen. Das ist normal, kann beim Testen aber verwirrend sein.

Die alte Website ist noch online und erhält Bestellungen

Das ist das größte Risiko für E-Commerce- und Mitgliederwebsites.

Wenn Kunden auf der alten Website weiterhin Bestellungen aufgeben, sich registrieren oder Formulare absenden, nachdem die Datenbank kopiert wurde, existieren diese neuen Daten nur auf dem alten Server. Wird die alte Website dann gelöscht, können die Daten verloren gehen. Bleiben beide Websites online, verteilen sich Ihre Daten auf zwei Orte.

Fehler beim Datenbankimport

Der Datenbankimport kann fehlschlagen, weil:

die Datei für das Upload-Limit zu groß ist
beim Import eine Zeitüberschreitung auftritt
der neue Datenbankserver eine andere Version verwendet
ein Zeichensatz oder eine Kollation nicht unterstützt wird
das Tabellenpräfix nicht zu wp-config.php passt

Eine nur teilweise importierte Datenbank kann Fehler, fehlende Inhalte oder die Meldung „Error establishing a database connection“ verursachen.

Dateiberechtigungen und Serverkonfiguration

Auf dem neuen Server gehören Dateien möglicherweise dem falschen Nutzer oder haben falsche Berechtigungen. Das kann WordPress daran hindern, Medien hochzuladen, Updates zu installieren oder überhaupt zu laden. Unterschiede in der PHP-Version oder bei den Serverregeln können ebenfalls Fehler verursachen, die es vorher nicht gab.

Löschen Sie die alte Website nicht

Bis die neue Website vollständig getestet ist, ist die alte Website Ihr Sicherheitsnetz.

Behalten Sie:

das alte Hosting-Konto aktiv
die alten Dateien und die alte Datenbank
ein vollständiges Backup, das vor Beginn der Migration erstellt wurde

Wenn die alte Website noch Bestellungen oder Registrierungen erhält, fragen Sie einen Entwickler, wie Sie damit umgehen sollten. Je nach Situation ist es besser, sie in den Wartungsmodus zu versetzen, umzuleiten oder eine abschließende Datensynchronisation zu planen. Treffen Sie diese Entscheidung nicht überstürzt, denn sie bestimmt, wo Ihre Daten am Ende landen.

Verstehen Sie zuerst, wo die Migration abgebrochen ist

Versuchen Sie, diese Fragen zu beantworten:

Welche Methode wurde verwendet: ein Migrations-Plugin, ein Tool des Hostings, eine manuelle Kopie?
Hat sich die Domain geändert oder nur der Server?
Wurde die Domain bereits auf den neuen Server verwiesen?
Hat der Vorgang eine Fehlermeldung angezeigt?
Wann wurde die Datenbank kopiert?
Hat seitdem jemand Bestellungen aufgegeben oder Inhalte bearbeitet?
Ist die alte Website noch online?

Notieren Sie, was Sie wissen. Schon ein lückenhafter Zeitablauf ist sehr nützlich.

Was können Sie gefahrlos prüfen?

Prüfen Sie, welchen Server Sie tatsächlich sehen

Wegen der DNS-Verbreitung und des Cachings sehen Sie möglicherweise die alte Website, ohne es zu merken. Fragen Sie Ihren Hosting-Anbieter, wie Sie eine Vorschau der neuen Website öffnen, oder prüfen Sie, wohin die Domain verweist (siehe Abschnitt für Praktiker).

Vergleichen Sie die alte und die neue Website

Öffnen Sie dieselben Seiten in beiden Versionen und vergleichen Sie:

die Startseite und einige Unterseiten
Bilder und Downloads
Formulare und Suche
die Login-Seite und das Dashboard
den Shop, den Warenkorb und den Checkout, falls vorhanden

Notieren Sie, welche Seiten abweichen oder fehlerhaft sind.

Prüfen Sie die Adresseinstellungen der Website

Wenn Sie auf der neuen Website auf das Dashboard zugreifen können, gehen Sie zu Settings > General (Einstellungen > Allgemein) und sehen Sie sich die WordPress-Adresse und die Website-Adresse an. Beide sollten die neue Adresse zeigen.

Ändern Sie sie nur, wenn Sie sicher sind, denn ein falscher Wert kann Sie aus dem Dashboard aussperren.

Wenden Sie sich an den Hosting-Anbieter

Der neue Hosting-Anbieter kann oft bestätigen, ob Dateien und Datenbank vollständig importiert wurden, Fehlerprotokolle bereitstellen und Berechtigungen oder PHP-Einstellungen prüfen. Viele Anbieter bieten auch Hilfe bei Migrationen an.

Was sollten Sie vermeiden?

Vermeiden Sie:

die alte Website, ihre Datenbank oder ihr Hosting-Konto zu löschen
die Migration ohne Backup erneut über eine teilweise funktionierende Website laufen zu lassen
in der Datenbank mit einem Texteditor oder einer einfachen SQL-Abfrage zu suchen und zu ersetzen
die DNS-Einstellungen wiederholt hin und her zu ändern
die alte und die neue Website gleichzeitig für Bestellungen offen zu lassen
Dateiberechtigungen auf die offenste Einstellung zu setzen, damit „es funktioniert“
wp-config.php zu bearbeiten, ohne eine Kopie des Originals aufzubewahren

Einfaches Suchen und Ersetzen ist besonders riskant. Manche WordPress-Daten werden in einem serialisierten Format gespeichert, das die Länge jedes Textes festhält. Wenn Sie den Text ändern, ohne die Länge anzupassen, können Plugin-Einstellungen, Widgets und Theme-Optionen beschädigt werden. Tools, die für WordPress entwickelt wurden, berücksichtigen das korrekt.

Wann sollten Sie technische Unterstützung anfragen?

Technische Unterstützung ist empfehlenswert, wenn:

die Website ein Onlineshop, eine Mitgliederwebsite oder ein Buchungssystem ist
nach dem Kopieren möglicherweise Bestellungen oder Registrierungen auf der alten Website eingegangen sind
der Datenbankimport fehlgeschlagen ist oder Sie nicht sicher sind, ob er vollständig ist
sich die Domain geändert hat und Links noch auf die alte verweisen
Sie auf der neuen Website nicht auf das Dashboard zugreifen können
die alte Website bereits gelöscht wurde
Sie kein überprüftes Backup haben
die Migration von jemandem durchgeführt wurde, der nicht mehr erreichbar ist

Sie müssen nicht genau verstehen, wo die Migration fehlgeschlagen ist. Eine Beschreibung dessen, was Sie auf der alten und der neuen Website sehen, reicht für den Anfang.

Welche Informationen sollten Sie sammeln?

Hilfreiche Angaben sind:

die alte und die neue Domain, falls unterschiedlich
der alte und der neue Hosting-Anbieter
die verwendete Migrationsmethode oder das verwendete Plugin
Datum und Uhrzeit der Migration
alle Fehlermeldungen, mit Screenshots
ob die Domain bereits auf den neuen Server verweist
ob die alte Website noch online ist
ob nach dem Kopieren neue Bestellungen, Nutzer oder Inhalte hinzugekommen sind
wo Backups gespeichert sind und wann sie erstellt wurden

Senden Sie keine Passwörter oder Hosting-Zugangsdaten per gewöhnlicher E-Mail. D4Hub kann Ihnen erklären, wie Sie Zugänge sicher teilen.

Wie D4Hub helfen kann

Ziel ist es, den Umzug ohne Datenverlust abzuschließen und sicherzustellen, dass die neue Website genauso gut funktioniert wie die alte.

Je nach Situation unterstützt D4Hub Sie bei:

der Prüfung, ob Dateien und Datenbank vollständig kopiert wurden
der Behebung von Fehlern beim Datenbankimport
der sicheren Aktualisierung alter Adressen, einschließlich serialisierter Daten
der Lösung von Problemen mit gemischten Inhalten und SSL
der Prüfung der DNS-Einträge und der Planung der Umstellung
dem Schutz von Bestellungen und Registrierungen, die während des Umzugs auf der alten Website eingehen
der Korrektur von Dateiberechtigungen und Serverkonfiguration
dem seitenweisen Vergleich der alten und der neuen Website
der Abstimmung mit dem alten und dem neuen Hosting-Anbieter
dem Testen von Formularen, Login, Checkout und anderen wichtigen Funktionen
der Entscheidung, wann die alte Website sicher abgeschaltet werden kann

Sie können in jeder Phase des Vorgangs Unterstützung anfragen.

D4Hub kann zum Beispiel:

den Plan prüfen, bevor Sie es erneut versuchen
eine Migration übernehmen, die auf halbem Weg stehen geblieben ist
den gesamten Umzug samt Tests durchführen
die neue Website prüfen, nachdem Sie fertig sind

Support-Ticket eröffnen

Für Praktiker: technische Prüfungen nach einer fehlgeschlagenen Migration

Die folgenden Prüfungen richten sich an Personen, die sicher mit einem Terminal, SFTP und WP-CLI umgehen.

Erstellen Sie vor jeder Änderung ein frisches Backup der Dateien und der Datenbank der neuen Website und stellen Sie sicher, dass die alte Website und ihr Backup noch verfügbar sind. Ändern Sie immer nur eine Sache.

Ersetzen Sie in den Beispielen example.com, old-domain.com und new-domain.com durch Ihre eigenen Domains.

Prüfen Sie, wohin die Domain verweist

dig example.com A +short
dig www.example.com +short

Vergleichen Sie das Ergebnis mit der IP-Adresse des alten und des neuen Servers. Um zu sehen, was ein öffentlicher DNS-Resolver derzeit zurückgibt, können Sie ihn direkt abfragen:

dig @1.1.1.1 example.com A +short
dig @8.8.8.8 example.com A +short

Wenn verschiedene Resolver unterschiedliche Adressen zurückgeben, verbreitet sich die Änderung noch. Wenn Sie ein CDN mit aktiviertem Proxy nutzen, sehen Sie statt Ihres Servers die Adressen des CDN.

Prüfen Sie die Adresse, die WordPress verwendet

Auf dem neuen Server, im WordPress-Ordner:

wp option get siteurl
wp option get home

Beide sollten die neue Adresse zeigen, einschließlich https://, wenn die Website SSL verwendet. Wenn WP_HOME oder WP_SITEURL in wp-config.php definiert sind, überschreiben sie die Werte der Datenbank. Prüfen Sie daher auch diese Datei.

Ersetzen Sie die alte Domain sicher

Erstellen Sie zuerst ein Backup der Datenbank:

wp db export before-search-replace.sql

Führen Sie dann einen Probelauf durch. Er zeigt, wie viele Ersetzungen vorgenommen würden, ohne etwas zu ändern:

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --dry-run

wp search-replace verarbeitet serialisierte Daten korrekt, was ein einfaches Ersetzen per SQL nicht tut. Prüfen Sie das Ergebnis sorgfältig: Stellen Sie sicher, dass der alte Wert exakt stimmt, einschließlich https:// und gegebenenfalls www, damit Sie keinen fremden Text ersetzen.

Viele Entwickler fügen --skip-columns=guid hinzu, damit die internen Kennungen der Beiträge nicht verändert werden. Führen Sie den Befehl erst ohne --dry-run aus, wenn Sie mit der Vorschau zufrieden sind und das Backup haben.

Leeren Sie nach der Ersetzung alle Caches und prüfen Sie einige Seiten und Bilder.

Suchen Sie nach gemischten Inhalten

Öffnen Sie eine Seite im Browser, öffnen Sie die Entwicklertools und prüfen Sie den Tab Console (Konsole). Warnungen wegen gemischter Inhalte listen Ressourcen auf, die über http:// geladen werden. Sie stammen oft von alten Adressen im Inhalt, in den Theme-Einstellungen oder in den Daten eines Page Builders.

Vergleichen Sie die Anzahl der Dateien und Tabellen

Zählen Sie auf dem alten und dem neuen Server die Dateien in wp-content:

find wp-content -type f | wc -l

Und die Datenbanktabellen:

wp db tables --all-tables | wc -l

Die Zahlen müssen nicht exakt übereinstimmen, etwa wegen Cache-Dateien, aber ein großer Unterschied deutet auf eine unvollständige Kopie hin. Sie können auch die Größe des Upload-Ordners vergleichen:

du -sh wp-content/uploads

Prüfen Sie außerdem, ob der Wert $table_prefix in wp-config.php zum Präfix der importierten Tabellen passt.

Prüfen Sie die Datenbank

wp db check

Damit werden die Tabellen auf Fehler geprüft. Wenn der Import mit einem Fehler zu Kollation oder Zeichensatz abgebrochen ist, ist der neue Datenbankserver möglicherweise älter oder anders konfiguriert. Fragen Sie den Hosting-Anbieter, welche Versionen verwendet werden, bevor Sie es erneut versuchen.

Prüfen Sie die Dateiberechtigungen

Eine übliche Einrichtung ist 755 für Ordner und 644 für Dateien, wobei wp-config.php oft restriktiver eingestellt ist. Die richtigen Werte und der Eigentümer der Dateien hängen vom Server ab. Sprechen Sie daher mit Ihrem Hosting-Anbieter, bevor Sie sie ändern. Setzen Sie Dateien oder Ordner niemals auf 777.

D4Hub kann Ihnen helfen, die Ergebnisse zu interpretieren und den nächsten sicheren Schritt zu planen.

Häufig gestellte Fragen

Ist meine alte Website weg?

Nicht, wenn sie nicht gelöscht wurde. Die meisten Migrationen kopieren Daten, statt sie zu verschieben, daher bleibt die ursprüngliche Website normalerweise auf dem alten Server, bis jemand sie entfernt. Behalten Sie sie, bis die neue Website vollständig geprüft ist.

Wie lange dauert die DNS-Verbreitung?

Das hängt von den DNS-Einstellungen ab und davon, wie lange Resolver die alten Informationen vorhalten. Es kann schnell gehen oder länger dauern. In dieser Zeit erreichen manche Besucher möglicherweise noch den alten Server. Planen Sie die Umstellung entsprechend.

Kann ich die Migration einfach noch einmal ausführen?

Manchmal, aber stellen Sie zuerst sicher, dass Sie verstehen, warum sie fehlgeschlagen ist, und sichern Sie die neue Website in ihrem aktuellen Zustand. Wenn Sie denselben Vorgang erneut ausführen, stoßen Sie möglicherweise auf dasselbe Problem oder überschreiben Änderungen, die seit dem ersten Versuch vorgenommen wurden.

Nach der Migration sind auf der alten Website Bestellungen eingegangen. Was nun?

Löschen Sie die alte Website nicht. Diese Bestellungen existieren nur in der alten Datenbank und müssen übertragen oder manuell erfasst werden. Das ist heikle Arbeit, besonders bei Shops mit Lagerverwaltung und Abos, und ein guter Moment, um Hilfe zu holen.

Warum werden Bilder noch von der alten Domain geladen?

Bildadressen sind im Inhalt und in einigen Einstellungen gespeichert. Wenn sich die Domain geändert hat, müssen sie mit einem Tool aktualisiert werden, das serialisierte WordPress-Daten verarbeiten kann, etwa wp search-replace. Möglicherweise funktionieren sie jetzt nur, weil die alte Website noch online ist.

Kann D4Hub helfen, wenn die Migration von jemand anderem durchgeführt wurde?

Ja. Teilen Sie uns mit, was Sie über den Ablauf der Migration wissen und was Sie jetzt sehen. D4Hub kann beide Websites prüfen und den sichersten Weg finden, den Umzug abzuschließen.

Meine WordPress-Migration ist fehlgeschlagen: was tun?