Wenn ONLYOFFICE nach dem Export eines Dokuments als PDF die Meldung „Download fehlgeschlagen“ anzeigt, ermitteln Sie zunächst die Fehlerursache: die PDF-Erstellung, die Übertragung von ONLYOFFICE auf Ihr Gerät oder das Speichern im Browser. Ein erfolgreicher Export erzeugt eine nicht leere PDF-Datei, die sich öffnen lässt und wichtige Seitenumbrüche, Tabellen und Schriftarten beibehält. Führen Sie die folgenden Prüfungen der Reihe nach durch; jede Prüfung hilft, die Fehlerursache einzugrenzen, ohne das Originaldokument zu verändern.
Beginnen Sie damit, Ihre ONLYOFFICE-Version zu ermitteln.
Im Online-Dokumenteneditor lautet der dokumentierte Pfad: Datei > Herunterladen als > PDF . Mit „Kopie speichern unter“ wird eine Kopie im Portal gespeichert, anstatt sie auf Ihren Computer herunterzuladen. In Desktop-Editoren verwenden Sie Datei > Speichern unter und wählen PDF. Die Bezeichnungen und verfügbaren Optionen variieren je nach Anwendung und Version. Gehen Sie daher nicht davon aus, dass ein Online-Menü in der Desktop-Anwendung vorhanden ist. Beachten Sie die Anweisungen von ONLYOFFICE zum Herunterladen und Drucken von Dokumenten sowie die Anleitung zur Registerkarte „Datei“ .
Wenn Sie eine bestehende PDF-Datei im Online-PDF-Editor bearbeiten, finden Sie den Download-Prozess ebenfalls unter „Datei“. Es handelt sich jedoch um einen anderen Editor. Befolgen Sie die Anweisungen für die aktuell geöffnete Anwendung.
1. Schützen Sie Ihre Änderungen vor der Fehlerbehebung.
Speichern Sie das Quelldokument, bevor Sie einen Export wiederholen. Im Online-Editor verwenden Sie Strg+S oder, falls verfügbar, Datei > Speichern und warten Sie, bis die Speicheranzeige erscheint. ONLYOFFICE speichert Dokumente im Online-Editor automatisch. Sie sollten jedoch vor dem Aktualisieren oder Schließen der Sitzung überprüfen, ob die aktuellen Änderungen gespeichert wurden. Speichern Sie die Arbeitsdatei in Desktop-Editoren zunächst wie gewohnt.
Erstellen Sie anschließend eine Kopie des Dokuments und testen Sie den Export mit dieser Kopie. So können Sie gefahrlos prüfen, ob das Original exportiert wurde. Vermeiden Sie es, wiederholt auf „Exportieren“ zu klicken, solange ein Exportvorgang noch läuft; sich überschneidende Downloads können es erschweren, festzustellen, welche Datei erfolgreich exportiert wurde.
2. Verwenden Sie ein kleines Testdokument, um den Fehler zu isolieren.
Erstellen Sie ein neues einseitiges Dokument mit einer kurzen Textzeile und exportieren Sie es mit derselben App und demselben Gerät als PDF. Prüfen Sie, ob die PDF-Datei in der Downloadliste des Browsers oder im im Speicherdialog ausgewählten Ordner angezeigt wird und ob die Dateigröße größer als null ist. Öffnen Sie die Datei in einem PDF-Viewer und vergewissern Sie sich, dass der Text lesbar ist.
- Die Test-PDF funktioniert: Der Exportpfad ist verfügbar. Die Originaldatei enthält möglicherweise Inhalte oder Formatierungen, die ein Konvertierungsproblem verursachen, oder der Download ist ungewöhnlich groß oder langsam. Verwenden Sie daher eine Kopie des Originals und vereinfachen Sie große Bilder, eingebettete Objekte oder komplexe Layouts schrittweise – Kategorie für Kategorie.
- Der Test der PDF-Datei schlägt auch im Online-Editor fehl: Überprüfen Sie die Browser-Downloads und versuchen Sie den unten beschriebenen alternativen Weg. Sollte das Problem weiterhin browser- und benutzerübergreifend auftreten, muss möglicherweise der Online-Dienst oder dessen Integration überprüft werden.
- Die Test-PDF funktioniert in Desktop-Editoren, aber nicht online: Das Problem hängt wahrscheinlich eher mit dem Browser, der Online-Sitzung, dem Portal oder der Verbindung zum Dokumentenserver zusammen als mit dem PDF-Export im Allgemeinen.
Dieser Vergleich dient als diagnostischer Hinweis, beweist aber keine eindeutige Ursache. Notieren Sie sich die verwendete Anwendung, den Browser, die Uhrzeit, die Dokumentgröße und ob der Fehler nur eine oder alle Dateien betrifft.
3. PDF-Generierung vom Browser-Download trennen.
Wählen Sie im Online-Editor einmal „Datei“ > „Herunterladen als“ > „PDF“ und überprüfen Sie anschließend den Download-Bereich Ihres Browsers. Falls eine Datei aufgeführt ist, verwenden Sie die Browserfunktion „Im Ordner anzeigen“ oder eine ähnliche Funktion und prüfen Sie die Dateigröße. Lässt sich die Datei korrekt öffnen, wurde die PDF-Erstellung erfolgreich durchgeführt. Das verbleibende Problem liegt möglicherweise darin, wo der Browser die Datei gespeichert hat oder wie der Download verarbeitet wurde.
Wenn der Download blockiert, unterbrochen oder nicht abgeschlossen wird, überprüfen Sie die Download-Benachrichtigungen Ihres Browsers und den verfügbaren Speicherplatz Ihres Betriebssystems. Falls Ihr Browser oder Ihre Organisation Downloads von der Website blockiert, fragen Sie den Administrator, ob die Website Dateien herunterladen darf. Testen Sie dies einmalig mit einem anderen unterstützten Browser auf demselben Gerät oder einem anderen Gerät mit demselben Konto. Funktioniert der Download dort, überprüfen Sie die Download-Einstellungen, Erweiterungen, Sicherheitssoftware oder den lokalen Speicher des ersten Browsers, anstatt das Dokument zu ändern.
Der private Browsermodus kann helfen festzustellen, ob eine Browsererweiterung oder gespeicherte Websitedaten betroffen sind, jedoch nur, wenn Sie sich anmelden und dasselbe Dokument dort öffnen können. Er behebt keinen serverseitigen Exportfehler und ist möglicherweise nicht für verwaltete Konten geeignet. Löschen Sie nicht als ersten Schritt alle Browserdaten; dadurch werden Sie von nicht zugehörigen Diensten abgemeldet.
4. Versuchen Sie eine alternative Route und vergleichen Sie das Ergebnis.
Um ein Dokument im Online-Dokumenteditor zu öffnen, wählen Sie „Datei“ > „Kopie speichern unter “ und anschließend PDF, falls dieses Format angeboten wird. Dadurch wird eine Kopie im Portal gespeichert; der Downloadpfad vom Browser zum Computer wird dabei nicht überprüft. Lässt sich die Portalkopie öffnen, wurde wahrscheinlich eine PDF-Datei exportiert, und der direkte Downloadpfad ist das relevantere Problem.
Sie können als temporäre Lösung auch versuchen, als PDF zu drucken. ONLYOFFICE beschreibt eine Druckoption und weist darauf hin, dass Firefox drucken kann, ohne die PDF-Datei vorher herunterzuladen. Wählen Sie im Druckdialog ein PDF-Ziel aus, falls Ihr Browser oder Betriebssystem dies anbietet. Verwenden Sie in Desktop-Editoren die PDF-Option im Druckdialog, sofern verfügbar. Vergleichen Sie Seitenzahl, Seitenumbrüche und alle Inhalte in der Nähe der Ränder mit dem Original.
Die Funktion „Als PDF drucken“ ist nicht mit dem Exportieren identisch. Sie kann Drucklayouteinstellungen anwenden, die Seitenskalierung ändern oder Inhalte außerhalb des druckbaren Bereichs auslassen. Verwenden Sie diese Funktion nur, wenn die resultierende Datei Ihre Sichtprüfung besteht, insbesondere bei Formularen, Tabellenkalkulationen oder Dokumenten mit präziser Seitennummerierung.
5. Wenn Sie Desktop-Editoren verwenden, speichern Sie die Datei unter einem einfachen lokalen Pfad.
Wählen Sie in Desktop Editors „Datei“ > „Speichern unter“, dann „PDF“ und speichern Sie eine Kopie in einem beschreibbaren Ordner, z. B. im Ordner „Dokumente“. Geben Sie der Datei einen kurzen Namen mit normalen Buchstaben und Zahlen. Speichern Sie die Datei beim ersten Test nicht direkt auf einer Netzwerkfreigabe, in einem synchronisierten Ordner, auf einem Wechseldatenträger oder in einem geschützten Systemverzeichnis. Wenn die lokale Kopie funktioniert, versuchen Sie es anschließend erneut mit dem gewünschten Zielordner. Dieser Vergleich deutet auf ein Problem mit dem Zielordner oder den Berechtigungen hin.
Wenn der Speicherdialog abgeschlossen ist, aber keine nutzbare PDF-Datei angezeigt wird, prüfen Sie, ob der Ordner beschreibbar ist und über freien Speicherplatz verfügt. Schließen Sie einen PDF-Viewer, der die Zieldatei möglicherweise gesperrt hat, wählen Sie einen neuen Dateinamen und versuchen Sie es erneut. Falls nur ein Quelldokument fehlschlägt, während ein einfacher Test erfolgreich ist, erstellen Sie eine Arbeitskopie und testen Sie diese, nachdem Sie ungewöhnlich große oder beschädigte Datenträger entfernt oder ersetzt haben. Lassen Sie das Original unverändert, bis Sie die Kopie überprüft haben.
6. Wann ein Administrator den Server überprüfen sollte
Wenn der Fehler im Online-Editor bei allen Benutzern auftritt oder sowohl der direkte Download als auch das Kopieren über das Portal fehlschlagen, teilen Sie Ihrem ONLYOFFICE-Administrator bitte den Zeitpunkt des Fehlers, die ungefähre Größe des betroffenen Dokuments, den verwendeten Browser und dessen Version sowie mit, ob der Fehler auch bei einem kleinen Testdokument auftritt. Bei einer integrierten oder selbstgehosteten Installation sollte der Administrator die Protokolle des Dokumentenservers und der Plattform um diesen Zeitpunkt überprüfen, die Erreichbarkeit von Editor und Speicherplattform sicherstellen und kürzlich vorgenommene Änderungen an Proxy oder Netzwerk überprüfen.
Die Fehlerbehebungsreferenz von ONLYOFFICE ordnet bestimmte Editorfehler abgelaufenen Sicherheitstoken, abgebrochenen Sitzungen oder Speicherfehlern zu und empfiehlt Administratoren, die DocService-Protokolle und die Erreichbarkeit von Rückruffunktionen auf Speicherfehler zu überprüfen. Diese Meldungen dienen der Diagnose und erklären nicht jede Fehlermeldung „Download fehlgeschlagen“. Befindet sich die Instanz hinter einem Reverse-Proxy, überprüfen Sie die weitergeleiteten Host- und Protokollheader anhand der aktuellen ONLYOFFICE-Proxy-Konfigurationsanleitung . Administratoren können die Anweisungen zur Debug-Protokollierung von ONLYOFFICE befolgen , um detailliertere Informationen zu erhalten und die Protokollierung nach der Diagnose wieder auf den normalen Standard zurückzusetzen.
Ändern Sie keine JWT-Geheimnisse, deaktivieren Sie die Authentifizierung nicht und stellen Sie den Dokumentenserver nicht zu Testzwecken öffentlich zur Verfügung. Solche Änderungen können Sicherheits- und Integrationsprobleme verursachen und den Exportfehler weiterhin ungelöst lassen.
Wie man überprüft, ob das Problem behoben ist
Exportieren Sie zunächst ein kleines Testdokument und anschließend die Arbeitskopie des Originals. Prüfen Sie, ob jede PDF-Datei eine Dateigröße ungleich null hat, sich fehlerfrei öffnen lässt, die erwartete Seitenzahl aufweist und wichtige Texte, Tabellen, Bilder und Seitenumbrüche beibehält. Wenn Sie „Kopie speichern unter“ oder „Als PDF drucken“ verwendet haben, überprüfen Sie, ob sich die Datei im vorgesehenen Portal oder lokalen Ordner befindet, und vergleichen Sie ihr Layout mit dem normalen Export. Wenn nur ein Weg funktioniert, notieren Sie diesen Unterschied für Ihren Administrator; er weist auf den noch zu untersuchenden Schritt hin.
Offizielle Referenzen