Bilder werden nicht generiert

Wenn dein Beitrag erfolgreich veröffentlicht wurde, aber das Beitragsbild oder Body-Bilder nicht erschienen, gehe diese Seite der Reihe nach durch. Die häufigste Ursache liegt in Schritt 1 — es ist ein Umgebungsproblem statt eines Problems mit deiner Kampagne.

Bevor du loslegst

Öffne Tools → Site Health in WordPress. Structura fügt dort drei Probes hinzu, die aufleuchten, wenn die häufigsten Bilderzeugungs-Blocker vorliegen:

MySQL packet size is sufficient for background tasks
WordPress cron is enabled
WordPress uploads directory is writable

Wenn eines davon rot oder gelb markiert ist, behebe das zuerst — die Schritte unten zeigen jeden Fix.

Schritt 1: Ist MySQLs `max_allowed_packet` zu klein?

Das ist die mit Abstand häufigste Ursache, die wir bei Shared-Hosting sehen.

Was passiert. Structura stellt Bilderzeugungs-Aufgaben mit Action Scheduler in eine Warteschlange, die jede Aufgabe in der Tabelle wp_actionscheduler_actions speichert. Wenn die serialisierten Aufgabendaten größer als MySQLs Einstellung max_allowed_packet sind, lehnt die Datenbank die Zeile still ab. Kein PHP-Fehler, kein Fehler im Admin. Die Aufgabe wird einfach nie erstellt — also wird das Bild niemals generiert.

Structura 1.17+ fängt das beim Einstellen ab und zeigt den Fehlschlag in der Lauf-Detailansicht der Kampagne unter dem Schritt Visuals. Die Nachricht sieht so aus:

Featured image task could not be enqueued. Action Scheduler refused the write — this is usually a MySQL packet-size limit (max_allowed_packet) or a database-write failure on wp_actionscheduler_actions.

Wie du es behebst. Du musst max_allowed_packet auf mindestens 4 MB (4194304) erhöhen. Wie du das tust, hängt von deinem Hoster ab:

Shared-Hosting (Hostinger, SiteGround, Bluehost usw.) — öffne ein Support-Ticket und bitte sie, max_allowed_packet auf deiner Datenbank auf 4 MB oder größer zu erhöhen. Die meisten Hoster machen das innerhalb weniger Stunden; es ist eine häufige Anfrage.
Managed WordPress (Kinsta, WP Engine, Pressable) — dein Hoster hat bereits einen vernünftigen Wert gesetzt. Wenn Site Health das trotzdem markiert, öffne ein Support-Ticket und füge einen Screenshot der Site-Health-Karte bei.
VPS / selbst verwaltet — füge max_allowed_packet = 16M unter [mysqld] in /etc/mysql/my.cnf (oder dem Äquivalent auf deiner MySQL-/MariaDB-Installation) hinzu und starte den Datenbankdienst neu.

Nachdem die Änderung wirksam ist, lass eine Kampagne erneut laufen oder klicke Bild generieren auf dem Bearbeitungsbildschirm eines von Structura erzeugten Beitrags — das Bild sollte jetzt korrekt gespeichert werden.

Schritt 2: Ist WordPress-Cron deaktiviert?

Was passiert. Wenn deine wp-config.php define('DISABLE_WP_CRON', true); enthält und es keinen System-Cron gibt, der wp-cron.php aufruft, werden Hintergrund-Bilderzeugungs-Aufgaben in die Warteschlange gestellt, aber nie ausgeführt.

Wie du es behebst. Entweder:

Entferne die Konstante DISABLE_WP_CRON aus wp-config.php, oder
Füge einen serverseitigen Cron hinzu, der wp-cron.php jede Minute aufruft:


* * * * * wget -q -O - https://your-site.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Die meisten Managed-Hoster erledigen das für dich. Auf Shared-Hosting musst du den Cron-Job möglicherweise selbst in deinem Hosting-Panel einrichten.

Schritt 3: Ist das Uploads-Verzeichnis beschreibbar?

Was passiert. Generierte Bilder werden über den WordPress-Helfer media_handle_sideload() importiert, der in wp-content/uploads/YYYY/MM/ schreibt. Wenn dieses Verzeichnis (oder sein Eltern) nicht für PHP beschreibbar ist, schlägt der Sideload fehl. Site Health zeigt die exakte WordPress-Fehlermeldung.

Wie du es behebst. Mache das Uploads-Verzeichnis für den Webserver beschreibbar. Der typische Fix auf Linux-Hostern:


chown -R www-data:www-data wp-content/uploads
chmod -R 755 wp-content/uploads

Passe den Nutzer (www-data, apache, nobody usw.) an, um zum Webserver-Nutzer deines Hosters zu passen.

Schritt 4: Ist der Bild-Anbieter korrekt konfiguriert?

Wenn keine der obigen Umgebungsprüfungen ein Problem markiert hat, könnte das Problem anbieter-seitig sein.

Öffne Structura → Einstellungen → KI-Engine.
Bestätige, dass dein Bild-Anbieter verbunden ist (grünes Häkchen).
Wenn du im Free- oder Pro-Plan bist (BYOK), bestätige, dass der gewählte Anbieter bildfähig ist. Claude produziert nur Text — wenn du Claude für Bilder gewählt hast, überspringt Structura die Bilderzeugung still auf BYOK-Plänen (auf verwalteten Plänen ersetzen wir automatisch durch einen bildfähigen Anbieter).

Siehe KI-Einstellungen für eine vollständige Tour.

Schritt 5: Immer noch festgefahren?

Öffne den jüngsten Lauf der Kampagne über das Dashboard und sieh dir den Schritt Visuals in der Lauf-Detailansicht an. Die Fehlermeldung des Schritts nennt üblicherweise das genaue Versagen — kopiere sie in ein Support-Ticket zusammen mit:

Deiner Plan-Stufe
Deinem konfigurierten Bild-Anbieter
Dem Kampagnennamen
Der Kampagnen-Lauf-ID (sichtbar in der URL der Lauf-Detailansicht)
Einem Screenshot von Tools → Site Health

Kontaktiere den Support.