Zum Hauptinhalt springen

tool_failed

HTTP 500 · code: "tool_failed" · type: https://docs.formfeed.dev/errors/tool-failed

Ein PDF-Schritt ist innerhalb von Formfeed fehlgeschlagen, bei einer Quelle, die sich lesen ließ: der Passwortschutz, ein anderes PDF-Tool oder die PDF/UA-1-Validierung eines Renderings mit pdf.ua. Das ist ein Fehler von Formfeed, nicht Ihrer Anfrage. Es wurde nichts berechnet.

Eine Quelle, die sich gar nicht lesen lässt, antwortet mit source_invalid, eine verschlüsselte mit source_encrypted.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/tool-failed",
  "title": "PDF tool failed",
  "status": 500,
  "detail": "qpdf failed (2): …",
  "code": "tool_failed",
  "location": null,
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Das Programm, das PDFs verschlüsselt (/pdf/protect, post.password), ist an dem Dokument gescheitert.
  • Ein unerwarteter Fehler, während ein PDF-Tool das Dokument verarbeitet hat, etwa eine PDF-Struktur, die die Tools öffnen, aber nicht kopieren können.
  • Der Validator konnte die Datei eines Renderings mit pdf.ua nicht lesen (The PDF could not be validated against PDF/UA-1, mit dem reason des Validators).
  • Ein vorübergehender Fehler bei der Verarbeitung.

So beheben Sie es​

  • Wiederholen Sie einmal mit demselben Idempotency-Key. Scheitert es erneut, rendern Sie die Quelle neu und verwenden Sie die neue Rendering-ID.
  • Tritt der Fehler weiter auf, senden Sie die request_id an support@formfeed.dev.

Wiederholen?​

Einmal. Ein vorübergehender Fehler verschwindet bei einer Wiederholung mit demselben Idempotency-Key (Antworten 500 werden nicht unter dem Schlüssel gespeichert); ein Dokument, das ihn auslöst, scheitert wieder. Asynchrone Renderings mit einem post-Schritt wiederholt die Warteschlange, und sie enden als worker_exhausted, wenn jeder Versuch scheitert.