Fehlerbehebung
Die folgenden Fälle leiten sich aus konkreten Fehlerzuständen, Warnungen und Fallbacks im aktuellen Plugin-Code ab.
Exportierte Seite enthält nur einen Fehlerkommentar
Section titled “Exportierte Seite enthält nur einen Fehlerkommentar”Mögliche Ursache
Der Request an die interne Basis-URL schlägt fehl, liefert einen Status außerhalb 200–399 oder einen leeren Response-Body.
Lösung
- interne Basis-URL in der Exportkonfiguration prüfen
- sicherstellen, dass der WordPress-Server diese URL selbst erreichen kann
- Weiterleitungen und interne DNS-/Container-Namen prüfen
- PHP-Error-Log nach Meldungen mit
[FG Static Export]durchsuchen
Prüfung
Einen neuen Export starten und kontrollieren, ob die betroffene index.html reguläres Seiten-HTML enthält.
Assets fehlen im Export
Section titled “Assets fehlen im Export”Mögliche Ursache
Die Datei ist extern gehostet, verwendet ein nicht berücksichtigtes URL-Muster oder liegt außerhalb des von FG Static Export auflösbaren Dateisystems.
Lösung
- prüfen, ob die Asset-URL lokal ist
- bei Uploads prüfen, ob das Upload-Verzeichnis innerhalb von
ABSPATHliegt oder überUPLOADSabgebildet wird - bei integrationsspezifischen Dateien den Filter
fg_static_export_additional_filesverwenden - bei Theme-Assets prüfen, ob sie in
public,dist,buildoderassetsliegen oder direkt referenziert werden
Prüfung
Im Export-Verzeichnis nach der Datei suchen und den letzten Export-Log auf Asset-Warnungen prüfen.
AVIF-Datei aus einem Theme-Build-Verzeichnis fehlt
Section titled “AVIF-Datei aus einem Theme-Build-Verzeichnis fehlt”Mögliche Ursache
Die Safety-Net-Allowlist von copy_theme_build_assets() enthält in Version 5.5.4 kein avif.
Lösung
Sicherstellen, dass die Datei über eine erkannte lokale Asset-Referenz oder über das WordPress-Upload-Verzeichnis in den Export gelangt. Alternativ kann eine Integration sie über fg_static_export_additional_files bereitstellen.
Prüfung
Datei im Export suchen und die referenzierende Seite bzw. CSS-Datei kontrollieren.
ZIP wird nicht erstellt
Section titled “ZIP wird nicht erstellt”Mögliche Ursache
ZipArchive ist nicht verfügbar oder das ZIP kann nicht angelegt werden.
Lösung
PHP-ZIP-Unterstützung auf dem Server aktivieren und Schreibrechte des Verzeichnisses prüfen.
Prüfung
Im Deployment-Systemcheck muss ZipArchive verfügbar als verfügbar erscheinen. Danach Export mit aktivierter ZIP-Option erneut ausführen.
Export-Verzeichnis wird nicht geleert
Section titled “Export-Verzeichnis wird nicht geleert”Mögliche Ursache
Das Verzeichnis liegt außerhalb von ABSPATH, ist ABSPATH selbst oder kann nicht über realpath() aufgelöst werden.
Lösung
Ein dediziertes Export-Unterverzeichnis innerhalb von ABSPATH verwenden.
Prüfung
Neuen Export starten und den Export-Log auf Meldungen zum Leeren des Verzeichnisses prüfen.
Rsync wird nicht angeboten oder schlägt sofort fehl
Section titled “Rsync wird nicht angeboten oder schlägt sofort fehl”Mögliche Ursache
exec() ist deaktiviert oder rsync bzw. ssh fehlen auf dem WordPress-Server.
Lösung
Unter Deployment → Systemcheck prüfen, welche Voraussetzung fehlt. Gegebenenfalls eine andere verfügbare Methode verwenden.
Prüfung
Alle drei Bedingungen exec(), rsync und ssh müssen für die Rsync-Methode verfügbar sein.
Rsync meldet einen fehlenden SSH-Key
Section titled “Rsync meldet einen fehlenden SSH-Key”Mögliche Ursache
Im Profil ist ein SSH-Key-Pfad gesetzt, die Datei existiert aber nicht.
Lösung
Pfad korrigieren oder das Feld leeren, wenn die Verbindung anderweitig authentifiziert wird.
Prüfung
Deployment erneut starten und den Deployment-Log kontrollieren.
SFTP über PHP SSH2 erscheint nicht
Section titled “SFTP über PHP SSH2 erscheint nicht”Mögliche Ursache
Die PHP-Extension SSH2 ist nicht geladen; ssh2_connect() steht nicht zur Verfügung.
Lösung
SSH2 auf dem Server bereitstellen oder SFTP über phpseclib verwenden, wenn diese Methode verfügbar ist.
Prüfung
Im Systemcheck muss PHP SSH2 Extension verfügbar positiv angezeigt werden.
SFTP über phpseclib erscheint nicht
Section titled “SFTP über phpseclib erscheint nicht”Mögliche Ursache
Der Composer-Autoloader fehlt oder \phpseclib3\Net\SFTP ist nicht verfügbar.
Lösung
Composer-Abhängigkeiten installieren und sicherstellen, dass vendor/autoload.php im Plugin vorhanden und lesbar ist.
Prüfung
Im Systemcheck muss phpseclib verfügbar positiv angezeigt werden.
FTPS fällt auf FTP zurück
Section titled “FTPS fällt auf FTP zurück”Mögliche Ursache
FTPS ist im Profil aktiviert, aber ftp_ssl_connect() fehlt.
Lösung
PHP mit FTPS-Unterstützung bereitstellen oder eine andere verschlüsselte Deployment-Methode verwenden.
Prüfung
Im Systemcheck muss PHP FTPS verfügbar positiv sein. Andernfalls protokolliert das Plugin beim Lauf den Fallback auf FTP.
Remote Delete wirkt bei SFTP oder FTP nicht
Section titled “Remote Delete wirkt bei SFTP oder FTP nicht”Mögliche Ursache
Remote Delete ist im aktuellen Code nur für Rsync umgesetzt.
Lösung
Für synchrones Löschen Rsync mit --delete verwenden, sofern dies für das Zielsystem geeignet ist.
Prüfung
Beim SFTP-/FTP-Lauf erscheint im Deployment-Log ein Hinweis, dass Remote Delete dort nicht unterstützt wird.
WP-Cron läuft nicht wie erwartet
Section titled “WP-Cron läuft nicht wie erwartet”Mögliche Ursache
Cron ist deaktiviert, das Ereignis wurde nicht geplant oder WordPress erhält keine Requests, die WP-Cron auslösen.
Lösung
- Cron-Einstellung speichern
- geplante WordPress-Cron-Ereignisse prüfen
- bei Bedarf einen echten Server-Cron verwenden, der WordPress-Cron anstößt
Prüfung
Der Hook fg_static_export_cron_export muss geplant sein. Nach einem Lauf sollten Zeit und Log des letzten Exports aktualisiert sein.