Skip to Content
FehlerbehebungBilder werden nicht generiert

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.

Bei Cloud gibt es keinen Anbieter und keinen Schlüssel, den du prüfen musst: Structura übernimmt die Bilderzeugung für dich. Prüfe stattdessen, ob die Website ihre Bilder für den Monat schon aufgebraucht hat (90 oder 200, je nach deiner Cloud-Option), und geh dann zu Schritt 5. In den Tarifen Free und BYOK:

  1. Öffne Structura → Einstellungen → KI-Engine.
  2. Bestätige, dass dein Bild-Anbieter verbunden ist (grünes Häkchen).
  3. Bestätige, dass der gewählte Anbieter bildfähig ist. Claude erzeugt nur Text. Wenn du Claude für Bilder gewählt hast, überspringt Structura die Bilderzeugung ohne Fehlermeldung.

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 (Free und BYOK)
  • Dem Kampagnennamen
  • Der Kampagnen-Lauf-ID (sichtbar in der URL der Lauf-Detailansicht)
  • Einem Screenshot von Tools → Site Health

Kontaktiere den Support.

Verwandte Seiten

Zuletzt aktualisiert am