ONLYOFFICEからPDFをエクスポートする際に発生する「ダウンロード失敗」エラーを修正する

ONLYOFFICEでドキュメントをPDFとしてエクスポートした後に「ダウンロード失敗」と表示される場合は、まずどの部分で失敗したのかを確認してください。PDFの生成、ONLYOFFICEからデバイスへの転送、またはブラウザでの最終保存のいずれかが失敗の原因です。エクスポートが成功すれば、重要な改ページ、表、フォントが保持された、中身が空でないPDFファイルが作成されます。以下の手順を順番に試してください。それぞれの手順で、元のドキュメントを変更することなく原因を絞り込むことができます。

まず、お使いのONLYOFFICEのバージョンを確認してください。

オンラインのドキュメントエディターでは、ドキュメントに記載されている手順は、[ファイル] > [ダウンロード] > [PDF]です。[コピーを保存] を選択すると、コンピューターにダウンロードされるのではなく、ポータルにコピーが保存されます。デスクトップエディターでは、[ファイル] > [保存]を選択し、[PDF] を選択します。ラベルと利用可能なオプションはアプリとバージョンによって異なるため、デスクトップアプリにオンラインメニューがあるとは限りません。ONLYOFFICE のドキュメントのダウンロードと印刷の手順、および[ファイル] タブのガイドを参照してください。

オンラインPDFエディターで既存のPDFを編集している場合、ダウンロード手順も「ファイル」メニューに表示されますが、エディターは異なります。実際に開いているアプリの手順に従ってください。

1. トラブルシューティングを行う前に編集内容を保護してください。

エクスポートを繰り返す前に、元のドキュメントを保存してください。オンラインエディターでは、Ctrl+S キーを押すか、可能であれば [ファイル] > [保存] を選択し、保存インジケーターが安定するまで待ちます。ONLYOFFICE のドキュメントには、オンラインエディターの自動保存機能が記載されていますが、セッションを更新または閉じる前に、現在の変更が保存されていることを確認することをお勧めします。デスクトップエディターでは、まず作業中のファイルを通常の方法で保存してください。

次に、ドキュメントのコピーを作成し、そのコピーに対してエクスポートを試してください。これにより、オリジナルを危険にさらすことなく安全にテストできます。リクエストの実行中にエクスポートを繰り返しクリックすることは避けてください。ダウンロードが重複すると、どのファイルが正常にエクスポートされたかを判断するのが難しくなります。

2. 小さなテスト文書を使用して、障害箇所を特定する

短いテキスト行を含む1ページの新規ドキュメントを作成し、同じアプリとデバイスを使用してPDFとしてエクスポートします。ブラウザのダウンロードリストまたはデスクトップの保存ダイアログで選択したフォルダにPDFが表示されるか確認し、ファイルサイズが0より大きいことを確認してください。PDFビューアで開き、テキストが正しく表示されることを確認してください。

• テスト用のPDFファイルは正常に動作しています。エクスポート先も確認できます。元のファイルには、変換時に問題を引き起こすコンテンツや書式設定が含まれているか、ダウンロードサイズが異常に大きいか、ダウンロードに時間がかかる可能性があります。元のファイルのコピーを使用して処理を進め、サイズの大きい画像、埋め込みオブジェクト、複雑なレイアウトなどを、カテゴリごとに一時的に簡略化してください。
• テスト用PDFもオンラインエディターでエラーが発生します。ブラウザのダウンロード履歴を確認し、以下の代替方法をお試しください。問題が複数のブラウザやユーザーで発生する場合は、オンラインサービスまたはその統合に問題がある可能性があります。
• テスト用のPDFファイルはデスクトップエディタでは正常に動作しますが、オンラインでは動作しません。この問題は、PDFのエクスポート全般というよりも、ブラウザ、オンラインセッション、ポータル、またはドキュメントサーバーへの接続に関連している可能性が高いです。

この比較は診断の手がかりとなるものであり、根本原因が一つであることを証明するものではありません。アプリ、ブラウザ、時間、ドキュメントサイズ、そして障害が特定のファイルのみに影響しているのか、すべてのファイルに影響しているのかを記録しておいてください。

3. PDF生成とブラウザからのダウンロードを分離する

オンラインエディタで、[ファイル] > [ダウンロード] > [PDF] を一度選択し、ブラウザのダウンロードパネルを確認してください。ファイルが一覧に表示されている場合は、ブラウザの「フォルダに表示」などの機能を使用してファイルサイズを確認してください。ファイルが正しく開けば、PDFの生成は成功です。残りの問題は、ブラウザがファイルをどこに保存したか、またはダウンロードをどのように処理したかにある可能性があります。

ダウンロードがブロックされたり、中断されたり、ファイルが見つからない場合は、ブラウザのダウンロード通知とオペレーティングシステムのディスク空き容量を確認してください。ブラウザまたは組織がサイトからのダウンロードをブロックしている場合は、管理者にサイトがファイルのダウンロードを許可されているかどうかを確認してください。一度だけテストする場合は、同じデバイスで別のサポートされているブラウザを使用するか、同じアカウントの別のデバイスを使用してください。そちらでダウンロードが成功した場合は、ドキュメントを変更するのではなく、最初のブラウザのダウンロード設定、拡張機能、セキュリティソフトウェア、またはローカルストレージに焦点を当ててください。

プライベートブラウジングは、拡張機能や保存されたサイトデータが原因かどうかを判断するのに役立ちますが、ログインして同じドキュメントを開くことができる場合に限ります。サーバー側のエクスポートエラーを修復するものではなく、管理アカウントには適さない場合があります。最初にブラウザのデータをすべて消去しないでください。無関係なサービスからログアウトしてしまう可能性があります。

4. 別のルートを試して結果を比較する

オンラインドキュメントエディタでドキュメントを開く場合は、「ファイル」>「コピーを保存」を選択し、PDF形式が表示されている場合はそれを選択してください。これにより、コピーがポータルに保存されます。ブラウザからコンピュータへのダウンロード経路はテストされません。ポータルにコピーが開いた場合は、エクスポートによってPDFが生成された可能性が高く、直接ダウンロード経路の方がより具体的な問題となります。

一時的な回避策として、PDFへの印刷も試してみてください。ONLYOFFICEのドキュメントには印刷オプションが記載されており、FirefoxではPDFをダウンロードせずに印刷できると記載されています。ブラウザまたはオペレーティングシステムにPDF出力先機能がある場合は、印刷ダイアログでPDF出力先を選択してください。デスクトップエディタでは、印刷ダイアログにPDFオプションがあればそれを使用してください。ページ数、改ページ、余白付近のコンテンツなどを元のファイルと比較してください。

PDFへの印刷は、通常のエクスポートとは異なります。印刷レイアウト設定が適用されたり、ページサイズが変更されたり、印刷可能領域外のコンテンツが省略されたりする場合があります。特にフォーム、スプレッドシート、ページ番号が厳密に設定されている文書など、生成されたファイルが目視で確認できる場合にのみ使用してください。

5. デスクトップエディタを使用する場合は、シンプルなローカルパスに保存してください。

デスクトップエディターで、[ファイル] > [名前を付けて保存] を選択し、[PDF] を選択して、書き込み可能なフォルダー（ドキュメントフォルダーなど）にコピーを保存します。ファイル名は、通常の英数字を使用した短いものにしてください。最初のテストでは、ネットワーク共有、同期フォルダー、リムーバブルドライブ、または保護されたシステムディレクトリに直接保存しないでください。ローカルコピーが正常に動作する場合は、その後、目的の保存先への保存を再度試してください。この比較から、保存先またはアクセス許可の問題が特定できます。

保存ダイアログが完了しても使用可能なPDFファイルが表示されない場合は、フォルダが書き込み可能で十分な空き容量があることを確認してください。対象ファイルがロックされている可能性のあるPDFビューアを閉じ、新しいファイル名を選択して再度試してください。基本的なテストは成功し、ソースドキュメントのうち1つだけが失敗した場合は、作業用コピーを作成し、異常に大きいメディアや破損したメディアを取り外したり交換したりしてからテストしてください。コピーの検証が完了するまで、元のファイルは変更しないでください。

6. 管理者がサーバーを検査すべき場合

オンラインエディターで全てのユーザーがエラーを確認した場合、または直接ダウンロードとポータルコピーの両方が失敗した場合は、ONLYOFFICE管理者に、試行日時、影響を受けるドキュメントのおおよそのサイズ、ブラウザとそのバージョン、および小さなテストドキュメントでもエラーが発生するかどうかをお知らせください。統合インストールまたはセルフホストインストールの場合、管理者は該当タイムスタンプ付近のドキュメントサーバーとプラットフォームのログを確認し、エディターとストレージプラットフォームが相互に通信できることを確認し、最近のプロキシまたはネットワークの変更点を確認してください。

ONLYOFFICE のトラブルシューティング リファレンスでは、特定のエディター エラーをセキュリティ トークンの期限切れ、セッションの切断、または保存エラーに関連付け、管理者に、保存失敗の原因として DocService ログとコールバックの到達可能性を確認するようアドバイスしています。これらのメッセージは関連する診断情報であり、「ダウンロード失敗」アラートすべてに対する普遍的な説明ではありません。インスタンスがリバース プロキシの背後にある場合は、転送されたホスト ヘッダーとプロトコル ヘッダーを最新のONLYOFFICE プロキシ構成ガイドと照らし合わせて確認してください。管理者は、ONLYOFFICE のデバッグ ログの手順に従って詳細情報を収集し、診断後にログを通常のレベルに戻すことができます。

JWTシークレットを変更したり、認証を無効にしたり、テスト目的でドキュメントサーバーを公開したりしないでください。これらの変更は、セキュリティやシステム統合上の問題を引き起こす可能性があり、エクスポートエラーも解決されないままになります。

問題が解決したことを確認する方法

まず、小さなテスト文書をエクスポートし、次に元の文書の作業用コピーをエクスポートします。各PDFファイルのサイズがゼロ以外であること、エラーなく開くこと、ページ数が想定どおりであること、重要なテキスト、表、画像、改ページが保持されていることを確認します。「名前を付けてコピーを保存」または「PDFに印刷」を使用した場合は、ファイルが目的のポータルまたはローカルフォルダにあることを確認し、通常のエクスポート結果とレイアウトを比較します。いずれか一方の方法のみが正常に動作する場合は、その違いを管理者に報告してください。これは、まだ調査が必要な段階を示しています。

公式資料

• ONLYOFFICE：ドキュメントの保存、ダウンロード、印刷
• ONLYOFFICE: ドキュメントエディター ファイルタブ
• ONLYOFFICE Docs トラブルシューティング リファレンス
• ONLYOFFICE ドキュメント（プロキシ経由）
• ONLYOFFICE Docsのデバッグログ