Fehlerbehebung
Die folgenden Fälle leiten sich aus den Prüfungen, Fallbacks und Admin-Meldungen im aktuellen Code von FG Image WP 1.0.4 ab.
Es werden keine WebP- oder AVIF-Dateien erzeugt
Section titled “Es werden keine WebP- oder AVIF-Dateien erzeugt”Mögliche Ursache
- Das gewünschte Format ist deaktiviert.
- Imagick/GD kann das Format nicht tatsächlich schreiben.
- Der Remote-Fallback ist deaktiviert oder nicht sicher konfiguriert.
- Das Upload-Verzeichnis ist nicht beschreibbar.
- Die Quelle ist nicht lesbar oder besitzt einen nicht unterstützten MIME-Typ.
- Die erzeugte Datei wäre nicht kleiner oder erreicht die Mindest-Ersparnis nicht.
Lösung
- Die aktivierten Formate in Konfiguration prüfen.
- Im Diagnose-Tab den Produktions-Check kontrollieren.
- Die Encoder-Fähigkeiten neu prüfen lassen.
- Bei Bedarf den optionalen Remote-Encoder konfigurieren und explizit testen.
- Für ein einzelnes Attachment die manuelle Generierung ausführen.
Prüfung
Im Einzelbild-Bericht kontrollieren, ob eine Variante als erzeugt, übersprungen oder fehlerhaft gemeldet wird. Ein Skip wegen zu geringer Ersparnis ist ein erwartetes Ergebnis und kein Encoder-Fehler.
AVIF oder WebP fehlt im Frontend, obwohl einige Dateien existieren
Section titled “AVIF oder WebP fehlt im Frontend, obwohl einige Dateien existieren”Mögliche Ursache
FG Image gibt einen modernen <source> nur aus, wenn alle für das vorhandene src/srcset erforderlichen Kandidaten dieses Formats registriert sind. Einzelne Varianten können beispielsweise wegen unzureichender Dateigrößenersparnis fehlen.
Lösung
Die Varianten des Attachments prüfen und gegebenenfalls neu generieren oder reparieren. Die Mindest-Ersparnis nur dann ändern, wenn kleinere Einsparungen fachlich gewünscht sind.
Prüfung
Das Frontend-Markup kontrollieren. Ist AVIF nicht vollständig, kann WebP verwendet werden; ist auch WebP nicht vollständig, bleibt das Original-<img> aktiv.
Eine registrierte Variante wurde manuell gelöscht
Section titled “Eine registrierte Variante wurde manuell gelöscht”Mögliche Ursache
Das Metafeld _fg_image_variants kennt die Datei noch, obwohl sie auf dem Dateisystem fehlt.
Lösung
Im Mediathek-Tab die Funktion Varianten prüfen/reparieren mit der Attachment-ID ausführen. Danach bei Bedarf Varianten erzeugen starten.
Prüfung
Die Reparatur sollte den fehlenden Eintrag aus den FG-Metadaten entfernen. Nach erneuter Generierung sollte die Datei wieder vorhanden und registriert sein, sofern die Konvertierungsbedingungen erfüllt sind.
Der Produktions-Check meldet „Remote konfiguriert, aber noch nicht getestet“
Section titled “Der Produktions-Check meldet „Remote konfiguriert, aber noch nicht getestet“”Mögliche Ursache
Lokal ist für ein aktiviertes Format kein Encoder vorhanden und ein Remote-Endpoint ist konfiguriert, aber der explizite Remote-Schreibtest wurde noch nicht erfolgreich durchgeführt.
Lösung
Im Diagnosebereich den Remote-Test ausführen. Der Test verwendet ein synthetisches 1×1-PNG.
Prüfung
Nach erfolgreichem Test sollte der Produktions-Check für das betreffende Format den Remote-Schreibpfad als verfügbar ausweisen.
Remote-Konvertierung wird trotz aktiviertem Remote-Dienst nicht ausgeführt
Section titled “Remote-Konvertierung wird trotz aktiviertem Remote-Dienst nicht ausgeführt”Mögliche Ursache
- Die lokale Konvertierung war erfolgreich.
- Die lokale Konvertierung wurde absichtlich wegen Dateigröße/Mindest-Ersparnis übersprungen.
- Die Quelldatei überschreitet das Remote-Limit.
- Der Endpoint ist wegen URL, Host, HTTP oder eingebetteten Zugangsdaten nicht als sicher konfiguriert.
Lösung
Die Remote-Konfiguration und den lokalen Ergebnisstatus prüfen. Der Remote-Dienst ist bewusst kein zweiter Optimierungsversuch nach einem lokalen Größen-Skip.
Prüfung
Ein Remote-Lauf ist nur zu erwarten, wenn der lokale Zielformat-Encoder fehlt oder die lokale Konvertierung mit Status error endet.
Batch-Verarbeitung bleibt stehen
Section titled “Batch-Verarbeitung bleibt stehen”Mögliche Ursache
Der Batch arbeitet in kleinen Admin-POST-Schritten und kann durch PHP-Zeitlimits, Serverfehler oder ein abgebrochenes Browser-/Admin-Verfahren unterbrochen werden. Der Fortschritt wird nach jedem Attachment gespeichert.
Lösung
Den vorhandenen Batch-Status erneut im Adminbereich öffnen und fortsetzen. Bei wiederkehrenden Fehlern das betroffene Attachment aus dem Fehlerbericht einzeln prüfen. Ein Batch kann außerdem zurückgesetzt und neu gestartet werden.
Prüfung
Der Zähler processed_attachments sollte weiter steigen. Fehler einzelner Attachments werden im Batch-Zustand protokolliert, ohne den bereits gespeicherten Fortschritt zu verlieren.
Ein Attachment wird wegen eines Generierungs-Locks übersprungen
Section titled “Ein Attachment wird wegen eines Generierungs-Locks übersprungen”Mögliche Ursache
Ein anderer Request verarbeitet dasselbe Attachment bereits. FG Image verwendet pro Attachment einen kurzlebigen Options-Lock.
Lösung
Doppelte parallele Generierung vermeiden. Verwaiste Locks laufen standardmäßig nach 300 Sekunden ab. Bei Deaktivierung/Aktivierung werden die FG-Image-Locks ebenfalls bereinigt.
Prüfung
Ein späterer einzelner Generierungslauf sollte nicht mehr als locked/zurückgestellt gemeldet werden.
Nach Aktivierung von FG Image verändert sich ein Grid-/Flex-Hero
Section titled “Nach Aktivierung von FG Image verändert sich ein Grid-/Flex-Hero”Mögliche Ursache
Ein zusätzlicher <picture>-Wrapper kann bei bestimmten CSS-Selektoren oder Layoutregeln relevant sein. Versionen vor 1.0.2 enthielten noch nicht die aktuelle Layoutneutralisierung.
Lösung
Mindestens FG Image 1.0.4 verwenden. Der aktuelle Code setzt von FG Image erzeugte Wrapper standardmäßig auf display: contents und überbrückt relevante Dimensionsvererbung.
Prüfung
Im DOM sollte der Wrapper class="fg-image-picture" besitzen. Das Inline-Stylesheet für .fg-image-picture sollte im <head> vorhanden sein.
Ein Bild in Bootstrap .ratio hat eine falsche Größe
Section titled “Ein Bild in Bootstrap .ratio hat eine falsche Größe”Mögliche Ursache
Bootstrap-.ratio-Layouts positionieren das direkte Kindelement. Ein neu eingefügtes <picture> muss daher selbst die Ratio-Box füllen.
Lösung
FG Image 1.0.4 verwenden. Diese Version enthält ausdrücklich .ratio > .fg-image-picture und eine Füllregel für das enthaltene <img>.
Prüfung
Der direkte .ratio-Child sollte das FG-Image-<picture> sein und 100 % Breite/Höhe erhalten.
Ein vorhandenes Theme-picture wird nicht erweitert
Section titled “Ein vorhandenes Theme-picture wird nicht erweitert”Mögliche Ursache
FG Image verändert vorhandene Pictures nur bei eindeutiger Zuordnung zu einem WordPress-Attachment mit registrierten Varianten. Externe oder unbekannte Bilder werden bewusst nicht verändert.
Lösung
Prüfen, ob das Fallback-<img> oder dessen Quellen einer WordPress-Attachment-URL entsprechen bzw. anderweitig eindeutig zuordenbar sind und ob vollständige Varianten existieren.
Prüfung
Bei erfolgreicher Zuordnung werden moderne Sources innerhalb des vorhandenen Pictures ergänzt, ohne ein neues Picture darum zu verschachteln.