Einen fehlgeschlagenen ONLYOFFICE-PDF-Export bis zu seiner Quelle zurückverfolgen

Speichern Sie zunächst das Quelldokument und prüfen Sie anschließend, ob der Fehler bei der PDF-Konvertierung durch ONLYOFFICE oder beim finalen Download im Browser auftritt. Meldet der Editor einen Konvertierungsfehler, überprüfen Sie die Protokolle des Dokumentenservers und stellen Sie sicher, dass der Server die Quelldatei erreichen kann. Wenn die Konvertierung erfolgreich war, der Browser aber „Download fehlgeschlagen“ anzeigt, überprüfen Sie stattdessen den Downloadstatus des Browsers, die Website-Berechtigungen und den verfügbaren Speicherplatz.

Beispielszenario: Stellen Sie sich Jordan vor, ein Administrator, der einen selbst gehosteten ONLYOFFICE Docs-Editor verwendet und für einen Projektbericht „Datei > Herunterladen als > PDF“ auswählt. Der Editor zeigt eine Fehlermeldung an, und es wird keine PDF-Datei erstellt. Dies ist ein hypothetisches Beispiel und kein getesteter Vorfall; das gleiche Symptom kann in verschiedenen Phasen des Prozesses auftreten. Die folgenden Prüfungen zielen daher auf den Punkt ab, an dem der Prozess abbricht.

1. Schützen Sie die Quelle und reproduzieren Sie den Fehler einmalig

Bevor Sie mit der Fehlerbehebung beginnen, speichern Sie Ihre Änderungen mit „Speichern“ oder Strg+S. Im Online-Dokumenteneditor von ONLYOFFICE ist der PDF-Exportpfad als „Datei > Herunterladen als > PDF“ hinterlegt. Der Editor kann die PDF-Datei zunächst vorbereiten und sie dann an den Browser senden. Ein fehlgeschlagener Browser-Download bedeutet daher nicht zwangsläufig, dass die Konvertierung selbst fehlgeschlagen ist.

Verwenden Sie denselben Bericht für einen kontrollierten Wiederholungsversuch. Achten Sie darauf, ob der Editor eine Fehlermeldung anzeigt, ob der Browser einen fehlgeschlagenen Download-Eintrag erstellt und ob das Problem nur diese Datei oder alle Dateien betrifft. Vermeiden Sie wiederholtes Klicken auf „Exportieren“: Doppelte Aufträge erschweren die Zuordnung eines Zeitstempels zum entsprechenden Serverprotokolleintrag.

2. Wenn der Browser einen fehlgeschlagenen PDF-Download anzeigt.

Öffnen Sie die Downloadseite Ihres Browsers und überprüfen Sie das fehlgeschlagene Element. Versuchen Sie es erneut. Prüfen Sie, ob der Browser Downloads von der ONLYOFFICE-Website blockiert hat, ob eine Downloadbestätigung in einem anderen Tab angezeigt wird und ob auf dem Ziellaufwerk genügend Speicherplatz vorhanden ist. Wenn Sie den Browser verwalten, testen Sie dasselbe gespeicherte Dokument in einem anderen Browser oder mit einem sauberen Browserprofil. Funktioniert es dort, überprüfen Sie die Browsereinstellungen, Erweiterungen oder Ihre lokale Sicherheitssoftware. Ändern Sie die Konfiguration des Dokumentenservers noch nicht.

Jordans hypothetischer Fall deutet darauf hin, dass der Browser die Ursache sein könnte, wenn der Editor die PDF-Erstellung abgeschlossen hat, die Downloadliste aber einen Netzwerk- oder Berechtigungsfehler meldet. Als praktische Alternative können Sie „Datei > Drucken“ verwenden und, falls verfügbar, die Option „Als PDF speichern“ Ihres Browsers oder Betriebssystems auswählen. Überprüfen Sie die resultierenden Seiten, Schriftarten und Links, da die Druckausgabe vom direkten PDF-Export des Editors abweichen kann. Diese Problemumgehung behebt jedoch keinen serverseitigen Konvertierungsfehler.

3. Falls die Konvertierung oder der Quellcodeabruf fehlschlägt

Bei einer selbstgehosteten Installation bitten Sie einen Administrator, die Protokolle des Dokumentenservers zum Zeitpunkt des erneuten Versuchs zu überprüfen. ONLYOFFICE protokolliert Linux-Protokolle unter `/usr/local/logs` /var/log/onlyoffice/documentserver; bei Docker befinden sich die Protokolle im Container unter diesem Pfad, und die Docker-Ausgabe kann auch mit `docker logs --log` eingesehen werden docker logs <container>. Die genaue Komponente und die Protokollbezeichnung hängen von der Installation und Version ab. Achten Sie auf Konvertierungsfehler, Timeouts, fehlgeschlagene Anfragen, HTTP-Statuscodes oder DNS- und Verbindungsfehler. Veröffentlichen Sie keine vollständigen Protokollzeilen, wenn diese private URLs, Zugriffstoken, Benutzernamen oder Dokumentnamen enthalten.

Wenn Protokolle oder die API ein Problem beim Herunterladen der Quelle melden, überprüfen Sie, ob der Dokumentenserver die URL des Quelldokuments aus seinem eigenen Netzwerk-Namespace erreichen kann. Ein Administrator kann die autorisierte URL vom Server oder Container aus testen und DNS, Routing, Firewall-Regeln, Proxy-Einstellungen, TLS-Zertifikate und die Antwort der Speicheranwendung überprüfen. Eine URL, die sich in Ihrem Desktop-Browser öffnen lässt, ist möglicherweise vom Dokumentenserver aus nicht erreichbar. Wenn die Quelle hingegen erfolgreich heruntergeladen wird, die Konvertierung aber fehlschlägt, untersuchen Sie den Konverterfehler, anstatt die Netzwerkzugriffsrechte zu ändern.

Bei API-basierten Konvertierungs-Workflows hilft der zurückgegebene Fehlercode, das Problem einzugrenzen. ONLYOFFICE definiert Konvertierungsfehler -4als Fehler beim Herunterladen der Eingabedatei, -2als Timeout, -3als Konvertierungsfehler oder -8als ungültiges Token. Diese Codes sind spezifisch für die Antwort der Konvertierungs-API; die allgemeine Meldung „Download fehlgeschlagen“ im Editor beweist nicht automatisch, dass eine PDF-Konvertierung einen dieser Fehler zurückgegeben hat.

4. Überprüfen Sie Zugriff, Berechtigungen und Größe nur dann, wenn Anhaltspunkte dafür vorliegen.

Wenn nur Dateien, die auf einer verbundenen Plattform gespeichert sind, nicht geladen werden können, überprüfen Sie die Adresse des Dokumentenservers und die internen Zugriffseinstellungen des Connectors. Der Bearbeitungsdienst muss die Datei von seinem Speichersystem abrufen können. Die Fehlerbehebungsdokumentation von ONLYOFFICE beschreibt die Fehlermeldung „Download fehlgeschlagen“ beim Laden des Editors als einen Fall, in dem der Bearbeitungsdienst nicht auf die Datei-URL zugreifen kann. Diese Anleitung ist hilfreich, wenn der Bericht nicht geöffnet oder geladen werden kann. Wenn sich der Editor normal öffnet und nur der PDF-Export fehlschlägt, überprüfen Sie zunächst den Export- oder Downloadvorgang.

Wenn die API ein ungültiges Token meldet, vergleichen Sie JWT-Secret, Header und Token-Konfiguration auf beiden Seiten. Deaktivieren Sie JWT nicht als Abkürzung. Wenn die API eine Größenbeschränkung angibt, vergleichen Sie die Datei mit den in Ihrer Bereitstellung konfigurierten Beschränkungen. Eine große Datei oder eine nicht unterstützte/beschädigte Quelle erfordert möglicherweise eine andere Lösung; der Wechsel des Browsers oder Netzwerks behebt weder eine Konvertierungsbeschränkung noch ein beschädigtes Dokument.

Aktivieren Sie die Debug-Protokollierung nur, wenn die regulären Protokolle nicht anzeigen, wo die Anfrage abgebrochen wird, und deaktivieren Sie sie wieder, nachdem Sie die benötigten Informationen gesammelt haben. Debug-Protokolle können sensible Anfragedetails enthalten. Befolgen Sie die Anweisungen von ONLYOFFICE für Ihren Installationstyp und teilen Sie Ihrem Administrator oder Supportteam einen anonymisierten Protokollauszug mit, anstatt Dokument-URLs oder Token offenzulegen.

Ergebnis überprüfen

• Prüfen Sie, ob die heruntergeladene Datei existiert, eine Größe ungleich Null hat und sich in einem PDF-Reader öffnen lässt.
• Vergleichen Sie die erste und letzte Seite, die Seitenzahl sowie einige wichtige Schriftarten oder Bilder mit der Quelle.
• Wiederholen Sie den Export nach der entsprechenden Korrektur. Falls er weiterhin fehlschlägt, notieren Sie die Uhrzeit, die ONLYOFFICE Docs-Version, den Exportstatus und den geschwärzten Fehlercode bzw. den Protokollauszug.

Die Dokumentation von ONLYOFFICE unterscheidet zwischen PDF-Download-Schritten und Konvertierungsfehlern. Detaillierte Informationen zu Ihrer Bereitstellung finden Sie in den Anweisungen zum Herunterladen und Drucken des Dokumenteneditors , im offiziellen Leitfaden zur Fehlerbehebung bei der Integration , in den Fehlercodes der Konvertierungs-API und im Leitfaden zur Debug- Protokollierung.