ONLYOFFICE PDFエクスポートの失敗の原因を特定する

まず元のドキュメントを保存し、エラーがONLYOFFICEのPDF変換で発生したのか、ブラウザの最終ダウンロードで発生したのかを判断してください。エディタで変換エラーが報告された場合は、ドキュメントサーバーのログを確認し、サーバーが元のファイルにアクセスできることを確認してください。変換は成功したがブラウザに「ダウンロード失敗」と表示される場合は、ブラウザのダウンロード状態、サイトのアクセス許可、および利用可能なディスク容量を確認してください。

具体例：管理者であるジョーダンが、自己ホスト型のONLYOFFICE Docsエディターを使用してプロジェクトレポートをPDF形式でダウンロードしようとしたとします。エディターにエラーが表示され、PDFファイルが作成されません。これはあくまで架空の例であり、実際にテストされた事例ではありません。同じ症状は処理の様々な段階で発生する可能性があるため、以下のチェック項目は処理が停止した時点から順に確認していきます。

1. ソースコードを保護し、一度だけ障害を再現する。

トラブルシューティングを行う前に、保存またはCtrl+Sを使用して現在の編集内容を保存してください。オンラインドキュメントエディターでは、ONLYOFFICEのドキュメントにはPDFのエクスポートパスが「ファイル」>「ダウンロード」>「PDF」と記載されています。エディターは最初にPDFを準備してから結果をブラウザーに渡す場合があるため、ブラウザーでのダウンロードが失敗した場合でも、必ずしも変換自体が失敗したとは限りません。

同じレポートを使用して、制御された再試行を1回実行してください。エディタにエラーダイアログが表示されるか、ブラウザにダウンロード失敗のエントリが作成されるか、問題がこのファイルのみに影響するか、すべてのファイルに影響するかを確認してください。エクスポートを繰り返しクリックすることは避けてください。重複したジョブがあると、タイムスタンプを対応するサーバーログエントリに照合するのが難しくなります。

2. ブラウザにPDFのダウンロード失敗が表示される場合

ブラウザのダウンロードページを開き、失敗した項目を確認してください。もう一度試してください。ブラウザがONLYOFFICEサイトからのダウンロードをブロックしていないか、別のタブでダウンロード確認メッセージが表示されているか、保存先のドライブに十分な空き容量があるかを確認してください。ブラウザを管理している場合は、保存した同じドキュメントを別のブラウザまたはクリーンなブラウザプロファイルでテストしてください。それで問題が解決する場合は、ブラウザの設定、拡張機能、またはローカルセキュリティソフトウェアに着目してください。ドキュメントサーバーの設定はまだ変更しないでください。

ジョーダン氏の仮説的なケースでは、エディタがPDFの準備を完了したにもかかわらず、ダウンロードリストにネットワークエラーまたは権限エラーが表示される場合、ブラウザに問題があると考えられます。実用的な代替策としては、[ファイル] > [印刷] を選択し、ブラウザまたはオペレーティングシステムの [PDFとして保存] 保存先（利用可能な場合）を選択することです。印刷出力はエディタの直接PDFエクスポートと異なる場合があるため、結果のページ、フォント、リンクを確認してください。この回避策は、サーバー側の変換エラーを修復するものではありません。

3. 変換またはソース取得が失敗した場合

セルフホスト型インストールの場合、再試行時に管理者にドキュメント サーバーのログを検査してもらうよう依頼してください。ONLYOFFICE は Linux ログを に記録します/var/log/onlyoffice/documentserver。Docker の場合、ログはそのパスにあるコンテナ内にあり、Docker の出力は で検査することもできますdocker logs <container>。コンポーネントとログの文言は、インストールとバージョンによって異なります。変換エラー、タイムアウト、失敗したリクエスト、HTTP ステータス コード、DNS および接続エラーを探してください。プライベート URL、アクセス トークン、ユーザー名、またはドキュメント名が含まれている場合は、ログ行全体を公開しないでください。

ログやAPIでソースのダウンロードに関する問題が検出された場合は、ドキュメントサーバーが自身のネットワークネームスペースからソースドキュメントのURLにアクセスできることを確認してください。管理者は、サーバーまたはコンテナから認証済みURLをテストし、DNS、ルーティング、ファイアウォールルール、プロキシ設定、TLS証明書、およびストレージアプリの応答を確認できます。デスクトップブラウザで開くURLであっても、ドキュメントサーバーからはアクセスできない場合があります。逆に、ソースのダウンロードは正常に完了するものの変換が失敗する場合は、ネットワークアクセスを変更するのではなく、コンバーターのエラーを調査してください。

API ベースの変換ワークフローでは、返されたエラーコードを使用して問題を絞り込んでください。ONLYOFFICE では、変換エラーを-4入力ファイルのダウンロードエラー、-2タイムアウト、-3変換エラー、-8無効なトークンとして定義しています。これらのコードは変換 API の応答に固有のものであり、エディターに表示される一般的な「ダウンロードに失敗しました」というメッセージだけでは、PDF 変換でこれらのエラーのいずれかが返されたことを証明するものではありません。

4. アクセス、権限、サイズを確認するのは、証拠がそれを示している場合に限る。

接続されたプラットフォームのうち1つに保存されているファイルのみが失敗する場合は、コネクタのドキュメントサーバーのアドレスと内部アクセス設定を確認してください。編集サービスは、ストレージシステムからファイルを取得できる必要があります。ONLYOFFICEのトラブルシューティングドキュメントでは、エディターの読み込み中に「ダウンロードに失敗しました」というエラーが発生する場合、編集サービスがファイルURLにアクセスできないことが原因であると説明されています。このガイダンスは、レポートが開かない、または読み込めない場合に役立ちます。エディターが正常に開き、PDFエクスポートのみが失敗する場合は、まずエクスポートまたはダウンロードの段階を確認してください。

APIがトークンが無効であると報告した場合は、両側のJWTシークレット、ヘッダー、およびトークン構成を比較してください。ショートカットとしてJWTを無効にしないでください。APIがサイズ制限を示している場合は、ファイルをデプロイメントで設定されている制限と比較してください。ファイルが大きい場合、またはサポートされていない/破損したソースの場合は、別の対処が必要になる場合があります。ブラウザやネットワークを変更しても、変換制限や破損したドキュメントは修正されません。

通常のログではリクエストの停止箇所が表示されない場合にのみデバッグログを有効にし、必要な証拠を収集したら無効に戻してください。デバッグログには機密性の高いリクエストの詳細が含まれる場合があります。インストールタイプに応じたONLYOFFICEの指示に従い、ドキュメントのURLやトークンを公開するのではなく、編集済みのログ抜粋を管理者またはサポートチームと共有してください。

結果を確認する

• ダウンロードしたファイルが存在し、サイズがゼロ以外であり、PDFリーダーで開くことを確認してください。
• 最初と最後のページ、ページ数、そしていくつかの重要なフォントや画像を、元の資料と照らし合わせて確認してください。
• 関連する修正を行った後、エクスポートをもう一度実行してください。それでも失敗する場合は、時刻、ONLYOFFICE Docsのバージョン、エクスポートの段階、および編集済みのエラーコードまたはログ抜粋を記録してください。

ONLYOFFICEのドキュメントでは、PDFのダウンロード手順と変換エラーを区別しています。詳細については、ドキュメントエディターのダウンロードと印刷手順、公式統合トラブルシューティングガイド、変換APIエラーコード、およびデバッグログガイドを参照してください。