修正從 ONLYOFFICE 匯出 PDF 時出現的「下載失敗」錯誤

如果 ONLYOFFICE 在您將文件匯出為 PDF 後顯示“下載失敗”，請先找出出錯的環節：PDF 產生、從 ONLYOFFICE 傳輸到您的設備，還是瀏覽器的最終保存。成功的匯出應該會產生一個非空的 PDF 文件，該文件可以開啟並保留重要的分頁符號、表格和字體。請依序嘗試以下檢查；每項檢查都可以在不更改原始文件的情況下縮小故障範圍。

首先確定您的 ONLYOFFICE 版本

在線上文件編輯器中，建議路徑為「文件」>「下載為」>「PDF」。「另存為副本」會將副本儲存到入口網站，而不是下載到您的電腦。在桌面編輯器中，請使用「檔案」>「另存為」，然後選擇「PDF」。不同應用程式和版本的標籤和可用選項可能有所不同，因此請勿假定桌面應用程式中存在線上選單。請參閱 ONLYOFFICE 的文件下載和列印說明以及「文件」標籤指南。

如果您正在使用線上 PDF 編輯器編輯現有 PDF 文件，其下載流程也位於「文件」功能表下，但它是由另一個編輯器完成的。請按照您目前開啟的應用程式的說明進行操作。

1. 在進行故障排除之前，請保護您的編輯內容。

再次匯出之前，請先儲存來源文件。在線上編輯器中，如果可用，請使用 Ctrl+S 或“檔案”>“儲存”，並等待儲存指示器穩定。 ONLYOFFICE 文件的線上編輯器會自動儲存，但您仍應在刷新或關閉工作階段之前確認目前變更已儲存。在桌面編輯器中，請先正常儲存工作文件。

然後複製一份文檔，再嘗試匯出副本。這樣可以安全地進行測試，而不會損壞原始文檔。避免在匯出請求仍在進行時反覆點擊「匯出」按鈕；重疊下載可能會導致難以判斷哪個檔案匯出成功。

2. 使用小型測試文件隔離故障

使用相同應用程式和裝置建立一個包含一行簡短文字的單頁文檔，並將其匯出為 PDF 文件。檢查該 PDF 檔案是否出現在瀏覽器的下載清單中或桌面儲存對話方塊中所選的資料夾中，並確認檔案大小大於零。使用 PDF 檢視器開啟該文件，並確保文字清晰可見。

測試 PDF 檔案可以正常匯出：匯出路徑可用。原始檔案可能包含導致轉換問題的內容或格式，或其下載檔案可能異常大或速度很慢。請使用原始文件的副本，並逐一簡化較大的圖像、嵌入物件或複雜的佈局。
測試 PDF 檔案在線上編輯器中也無法開啟：請檢查瀏覽器下載設置，並嘗試以下備用方法。如果問題在不同瀏覽器或使用者中仍然存在，則可能是線上服務或其整合存在問題。
測試 PDF 在桌面編輯器中可以正常運作，但在線上卻不行：問題更有可能與瀏覽器、線上工作階段、入口網站或文件伺服器連線有關，而不是與 PDF 匯出本身有關。

這種對比只是診斷線索，並不能證明某個根本原因。請記錄應用程式、瀏覽器、時間、文件大小，以及故障是影響單一文件還是所有文件。

3. 將 PDF 產生與瀏覽器下載分開

在線上編輯器中，選擇“檔案”>“下載為”>“PDF”，然後檢查瀏覽器的下載面板。如果列出了文件，請使用瀏覽器的「在資料夾中顯示」或類似功能，並檢查其大小。如果文件可以正常打開，則表示 PDF 產生成功；剩餘的問題可能在於瀏覽器保存文件的位置或瀏覽器處理下載的方式。

如果下載被封鎖、中斷或遺失，請檢查瀏覽器的下載通知和作業系統可用磁碟空間。如果您的瀏覽器或組織封鎖從該網站下載文件，請詢問管理員是否允許從該網站下載文件。您可以嘗試在同一裝置上使用另一個受支援的瀏覽器，或使用同一帳戶下的另一台裝置進行一次性測試。如果測試成功，請專注於檢查第一個瀏覽器的下載設定、擴充功能、安全軟體或本機存儲，而不是修改文件。

隱私瀏覽模式可以幫助判斷是否是瀏覽器擴充功能或網站儲存資料導致了問題，但前提是您必須能夠登入並開啟相同文件。它無法修復伺服器端匯出失敗的問題，而且可能不適用於託管帳戶。請勿先清除所有瀏覽器數據，否則可能會導致您退出一些無關的服務。

4. 嘗試其他路線並比較結果

對於線上文檔編輯器中的文檔，請嘗試“文件”>“另存為”，然後選擇 PDF 格式（如果提供該格式）。這會將副本儲存到入口網站；它不會測試從瀏覽器到電腦的下載路徑。如果入口網站副本可以打開，則匯出結果很可能是 PDF 文件，而直接下載路徑的問題就比較具體了。

您也可以嘗試將文件列印為 PDF 文件作為臨時解決方案。 ONLYOFFICE 文件中提供了列印選項，並指出 Firefox 無需先下載 PDF 檔案即可列印。如果您的瀏覽器或作業系統提供此功能，請在列印對話方塊中選擇 PDF 儲存位置。在桌面編輯器中，如果可用，請使用列印對話方塊中的 PDF 選項。將列印後的文件與原件進行比較，包括頁數、分頁符號以及頁邊距附近的任何內容。

列印到 PDF 與匯出並不相同。它可能會套用列印佈局設置，並可能更改頁面縮放比例或省略列印區域以外的內容。只有在產生的文件通過您的目視檢查後才使用此功能，尤其適用於表單、電子表格或具有精確分頁的文件。

5. 如果您使用桌面編輯器，請儲存到簡單的本機路徑。

在桌面編輯器中，選擇“檔案”>“另存為”，選擇 PDF 格式，並將副本儲存到您可寫入的資料夾，例如“文件”資料夾。文件名應使用普通字母和數字，並儘可能簡短。首次測試時，請勿直接儲存至網路共用、同步資料夾、可移動磁碟機或受保護的系統目錄。若本機副本儲存成功，請稍後重試儲存至目標位置；此比較結果有助於判斷問題是否出在目標位置或權限。

如果儲存對話方塊完成但未出現可用的 PDF 文件，請檢查資料夾是否可寫入且有足夠的可用空間。關閉可能鎖定目標檔案的 PDF 檢視器，選擇新的檔案名，然後重試。如果只有一個來源文件失敗，而基本測試成功，請建立工作副本，並在移除或更換異常大或損壞的媒體後進行測試。在驗證副本之前，請勿變更原始文件。

6. 管理員何時應該檢查伺服器

如果所有使用者在線上編輯器中都遇到此錯誤，或直接下載和入口網站複製都失敗，請向您的 ONLYOFFICE 管理員提供以下資訊：嘗試失敗的時間、受影響文件的大致大小、瀏覽器及其版本，以及小型測試文件是否也出現相同的問題。對於整合式或自託管式安裝，管理員應檢查該時間戳附近的文檔伺服器和平台日誌，確認編輯器和儲存平台之間可以互相訪問，並查看最近的代理或網路變更。

ONLYOFFICE 的故障排除參考文件將某些編輯器錯誤對應到過期的安全性令牌、會話斷開或儲存錯誤，並建議管理員檢查 DocService 日誌和回呼可達性以查找儲存失敗的原因。這些訊息是相關的診斷訊息，並非對所有「下載失敗」警報的通用解釋。如果實例位於反向代理程式之後，請根據最新的ONLYOFFICE 代理程式設定指南驗證其轉送的主機和協定標頭。管理員可以按照 ONLYOFFICE 的偵錯日誌記錄說明收集更多詳細信息，然後在診斷完成後將日誌等級還原為正常等級。

請勿變更 JWT 金鑰、停用身份驗證或將文件伺服器公開用於測試。這些變更可能會導致安全性和整合問題，並且無法解決匯出故障。

如何確認問題已解決

匯出一份小型測試文檔，然後匯出原始文檔的工作副本。確認每個 PDF 檔案的大小均不為零，可以正常打開，頁數符合預期，關鍵文字、表格、圖像和分頁符號均已保留。如果您使用了「另存為」或「列印到 PDF」功能，請確認檔案位於目標入口網站或本機資料夾中，並將其佈局與正常匯出的檔案進行比較。如果只有一種匯出方式有效，請記錄下此差異並告知管理員；這表示仍需調查的環節。

官方參考資料

留下評論

修正 ONLYOFFICE 文件伺服器在 VPS 上記憶體不足的問題

診斷 VPS 上的 ONLYOFFICE Docs 記憶體錯誤，檢查主機和 Docker 限制，查看日誌和遺忘的文檔，安全地添加交換空間，並在不影響正在進行的編輯的情況下重新啟動。

修正 Collabora Online 在本機應用程式之間複製貼上的問題

透過測試鍵盤快速鍵、瀏覽器剪貼簿權限、HTTPS、iframe 策略和內容格式，檢視 Collabora Online 與本機應用程式之間的複製和貼上問題。

修復 Linux 系統下 ONLYOFFICE Desktop 字型模糊問題：實用指南

透過以安全順序檢查顯示縮放、應用程式介面縮放、字體可用性和渲染範圍，修復 Linux 上 ONLYOFFICE 桌面編輯器中的模糊文字。

如何在 LibreOffice Writer 中建立互動式可填寫 PDF 表單

學習如何新增 Writer 表單控制項、設定標籤和製表符順序、啟用「建立 PDF 表單」功能匯出，以及在共用之前測試互動式 PDF。

如何在 ONLYOFFICE 中限制列印和下載

了解如何在 ONLYOFFICE Workspace、DocSpace 或 Docs 整合中封鎖列印和下載，並驗證哪些控制適用於每種共用方法。

如何修復 ONLYOFFICE 文件伺服器在 Nginx 後端的 502 Bad Gateway 錯誤

排查 Nginx 後端 ONLYOFFICE 文件伺服器的 502 錯誤。檢查服務運作狀況、日誌、上游連接埠、轉送的標頭、WebSocket 和 Docker 網路。

修正 ONLYOFFICE 行動應用連線到自架伺服器的逾時問題

透過檢查正確的入口網站或 WebDAV URL、網路存取、HTTPS、憑證和伺服器路由，排查 ONLYOFFICE Documents 逾時到自架伺服器的問題。

如何在 LibreOffice Writer 中變更預設文件模板

將自訂的 LibreOffice Writer 模板設為預設模板，更新或重設該模板，並驗證新文件是否使用您喜歡的樣式和頁面佈局。