# Beheben Sie häufige Probleme

Beheben Sie Renderfehler, fehlende Daten, blockierte Bilder und Seitenumbrüche.

## Die Vorschau funktioniert, das Rendern jedoch nicht
Überprüfen Sie die veröffentlichte Version, den Schlüssel/das Projekt, `template:render`, das Kontingent und die Vorschau-Ressourcenwarnungen. Die Vorschau kann unzulässige Bilder auslassen, während ein echtes Rendering sie ablehnt.

## Identifizieren Sie den Fehler, bevor Sie es erneut versuchen

| Code oder Symptom | Aktion |
| --- | --- |
| `PDF_TEMPLATE_VERSION_NOT_PUBLISHED` | Öffnen Sie die Zielversion im Editor und veröffentlichen Sie sie. Versuchen Sie dann den Job erneut. |
| `PDF_INVALID_API_KEY` / `PDF_API_KEY_INSUFFICIENT_SCOPE` | Überprüfen Sie den aktiven Schlüssel, das richtige Projekt und den `template:render`-Bereich. |
| `PDF_RENDER_QUOTA_EXCEEDED` / `quota_exceeded` | Überprüfen Sie die Arbeitsbereichsnutzung in den Einstellungen. Wiederholte POSTs stellen das Kontingent nicht wieder her. |
| `EXTERNAL_IMAGES_NOT_ALLOWED` | Lesen Sie die Vorschauwarnung und [Bildrichtlinie](/docs/de/assets/images/); Verwenden Sie die im Plan des Arbeitsbereichs zulässigen Ressourcen. |
| `ASSET_STORAGE_PLAN_REQUIRED` | Der Arbeitsbereich kann derzeit keine Projektressourcen bereitstellen. Überprüfen Sie den Plan und den Speicherhinweis in Assets. |
| `RENDER_TIMEOUT` | Vereinfachen oder teilen Sie große Inhalte, reduzieren Sie die Bildarbeit und überprüfen Sie die Verarbeitungsgrenze, bevor Sie es erneut versuchen. |
| 404 unmittelbar nach Render 202 | Behalten Sie die akzeptierte Render-ID bei und befolgen Sie die Statuswiederholungsanweisungen](/docs/de/developers/render-reference/). |
| PDF zeigt immer noch ein altes Etikett | Speichern Sie das Design und erstellen Sie dann die PDF-Vorschau neu. Run-Eingaben aktualisieren die Werte der Editorvorschau nicht. |

## Fehlende Daten
Überprüfen Sie Namen, `params`-Bindungen, Propsumfang und ausgewählte Variante. Überprüfen Sie in Arrays den Elementkontext und die vollständige JSON-Form.

## Ausschnitt oder überschüssiger Leerraum
Überprüfen Sie feste Höhen/Überlauf, Ränder, Schriftarten und Zusammenhalteeinstellungen. Beginnen Sie mit kleinen Eingaben und verwenden Sie die PDF-Vorschau, um physische Seitenübergänge zu lokalisieren.

## Der Download schlägt fehl
Bestätigen Sie den Erfolg, die beibehaltene Ausgabe und die Projektautorisierung. Download-URLs umgehen die Zugriffskontrollen nicht.

## HTTP 401/403
Überprüfen Sie den Ursprung von API, `ApiKey`, die aktuellen Anmeldeinformationen und die Bereiche. Der Schlüssel eines Projekts A kann nicht auf die Vorlage von Projekt B zugreifen. Senden Sie keine Geheimnisse an den Support.

## Agent-Revisionskonflikt
Lesen Sie den aktuellen Kontext erneut und gleichen Sie die Änderungen ab. Überschreiben Sie nicht blind eine neuere Revision. Unterscheiden Sie das Projekt `/mcp` vom öffentlichen `/docs/mcp` und verwenden Sie die richtigen Header.

## Reproduzierbar melden
Geben Sie Zeit, Aktion, Vorlage/Version, Render-/Liefer-IDs und bereinigte Fehler an. Bevorzugen Sie gefälschte Reproduktionsdaten und schwärzen Sie Anmeldeinformationen/persönliche Informationen in Screenshots.