Zum Hauptinhalt springen

Fehlerbehebung

Bricks2Etch meldet Probleme mit vollständiger Diagnose direkt im Adminbereich — du sollst nie aus einem generischen „Etwas ist schiefgelaufen" raten müssen. Diese Seite erklärt die wichtigsten Meldungen und was zu tun ist.

tipp

Jede der folgenden Meldungen landet auch im Migrationslog (Bricks2Etch → Logs). Wenn du den Support kontaktierst, hänge das Log bzw. ein Support-Bundle an — zusammen mit dem exakten Wortlaut der Meldung.

„Bricks2Etch: database tables could not be created."​

Wo: Admin-Hinweis in wp-admin, zusammen mit der Liste fehlender Tabellen und dem exakten MySQL-Fehler.

Warum: Das Plugin legt eigene Datenbanktabellen an (Migrationsstatus, Logs, Import-Queue, Locks). Auf manchen Managed-/gehärteten Hosts darf der WordPress-Datenbankbenutzer kein CREATE TABLE ausführen — die Tabellen entstehen dann stillschweigend nie, und jede Migrationsfunktion würde mit „table doesn't exist" scheitern.

Lösung:

  1. Bitte deinen Hoster, dem Datenbankbenutzer das CREATE- (und ALTER-)Privileg zu geben — der Hinweis zeigt den exakten MySQL-Fehler zum Weiterleiten.
  2. Lade eine beliebige wp-admin-Seite neu: Der Installer versucht es bei jedem Admin-Aufruf automatisch erneut; sobald die Tabellen existieren, verschwindet der Hinweis.

„Target site reports missing content after all data was sent …"​

Wo: als finaler Migrationsstatus auf der Quellsite (anstelle von „completed").

Warum: Nach dem Versand aller Batches fragt die Quelle bei der Zielsite nach, ob wirklich alles angekommen ist. Antwortet das Ziel „es fehlt Inhalt" (z. B. weil Import-Batches auf dem Ziel fehlgeschlagen sind), bricht Bricks2Etch den Lauf mit der Diagnose des Ziels ab, statt Erfolg vorzutäuschen. Die Meldung listet exakt die betroffenen Inhaltstypen, z. B. post (0/12).

Lösung:

  1. Öffne Bricks2Etch → Logs auf der Zielsite und suche nach fehlgeschlagenen Import-Batches im selben Zeitraum.
  2. Typische Ursachen: PHP-Memory/Timeouts auf dem Ziel beim Import großer Beiträge oder Medien (siehe Hosting-Hinweise) oder eine Security-Schicht, die Batch-Traffic blockiert.
  3. Ursache beheben (Limits erhöhen, Batch-Größe senken) und die Migration erneut starten — Importe sind idempotent: bereits angekommene Inhalte werden aktualisiert, nicht dupliziert.

„Target import queue did not finish within N minutes …"​

Wo: finaler Migrationsstatus auf der Quellsite, inklusive der Anzahl offener/fehlgeschlagener Batches.

Warum: Die Zielsite verarbeitet eingehende Batches asynchron über ihre eigene Job-Queue. Kommt diese Queue nicht mehr voran (z. B. weil das Hosting den Hintergrund-Worker abgeschossen hat), wartet die Quelle nicht mehr endlos — sie stoppt nach einem festen Zeitbudget und sagt dir, wo du nachsehen musst. Hängende Jobs auf dem Ziel werden zusätzlich automatisch erkannt und neu gestartet; dieser Fehler erscheint nur, wenn auch das nicht geholfen hat.

Lösung:

  1. Prüfe auf der Zielsite unter Werkzeuge → Geplante Aktionen (Action Scheduler) die Einträge efs_process_import_queue_batch auf „pending"/„failed".
  2. Prüfe die Bricks2Etch → Logs der Zielsite auf Batch-Fehler (Memory, Timeouts).
  3. Host-Limits anpassen und die Migration erneut starten. Für Fortgeschrittene: Das Wartebudget lässt sich über den Filter efs_finalization_drain_max_seconds anpassen.

TLS-Warnung: „TLS verification failed for media transport" (W027)​

Wo: Warnung im Migrationslog; die Migration läuft weiter.

Warum: Medientransfers prüfen das HTTPS-Zertifikat der Zielsite. Schlägt die Prüfung fehl (abgelaufen, self-signed, unvollständige Chain), versucht Bricks2Etch es für diesen Host einmalig ohne Prüfung erneut und protokolliert W027, damit du weißt, dass der Transport nicht verifiziert war.

Lösung: Repariere das TLS-Zertifikat der Zielsite. Lokale/Docker-Ziele mit self-signed Zertifikaten können die Warnung gefahrlos ignorieren.

„Bricks2Etch: obsolete plugin folder detected"​

Wo: Admin-Hinweis auf der Plugins-Seite.

Warum: Ältere Installationen (vor v0.45.0) nutzten den Ordner wp-content/plugins/etch-fusion-suite/. Nach dem Update liegt die aktuelle Installation in bricks2etch/, der alte Ordner ist ein Überbleibsel.

Lösung: Nutze den Button „Remove obsolete folder safely" im Hinweis — oder eine der dort gelisteten manuellen Optionen.

:::danger Den alten Eintrag NICHT über Plugins → Löschen entfernen Der alte Ordner enthält noch eine destruktive Legacy-uninstall.php (v0.44.5–v0.44.10), die Bricks-Builder-Layouts und globale Klassen löscht. Der Cleanup-Button des Hinweises und die gelisteten manuellen Wege (SFTP-Löschung, wp plugin delete etch-fusion-suite --skip-uninstall) umgehen sie sicher. :::

Migration-Key wird bei der Kopplung abgelehnt​

Warum: Keys sind zeitlich begrenzt und an die Zielsite gebunden.

Lösung: Erzeuge auf dem Ziel einen frischen Key und schließe die Kopplung zügig ab. Liegt das Ziel hinter Proxy/CDN, siehe Hosting-Hinweise — Security-Schichten können die REST-Aufrufe der Validierung blockieren.