當 ONLYOFFICE 無法儲存到 Nextcloud 時，追蹤會儲存回呼。

假設範例： Mina 在 ONLYOFFICE 中編輯 Nextcloud 資料夾中的專案計畫。編輯器打開並接受了她的更改，但 Nextcloud 隨後報告“文檔無法保存”。此範例僅為說明，並非實際測試報告。在這種情況下，請保持編輯器打開，保留未儲存工作的本機副本，並檢查 ONLYOFFICE Docs 是否可以直接存取 Nextcloud 的儲存回呼。然後使用日誌來區分回呼路由失敗和 Nextcloud 儲存或權限問題。

1. 在進行故障排除之前，請保護 Mina 的變更。

如果編輯器中仍有 Nextcloud 尚未儲存的更改，請勿關閉或刷新編輯器。如果編輯器仍然回應，請使用編輯器的「下載為」選項保留本機復原副本。請記錄保存失敗的時間和檔案名，以便管理員可以比對日誌。

在標準的 Nextcloud 資料夾中測試一個小的 DOCX 檔案。如果儲存成功，則專注於檢查原始檔案的權限、共用狀態、儲存方式或格式。如果所有檔案都無法儲存，則首先檢查共用回呼路由和伺服器運作狀況。

2. 檢查伺服器間儲存回調

ONLYOFFICE Docs 會向 Nextcloud 連接器提供的回呼 URL 傳送 POST 請求。 Nextcloud 隨後會檢索已編輯的檔案並更新其儲存的版本。如果文件伺服器無法將請求傳回 Nextcloud，則編輯器可以正常打開，但無法儲存。

使用測試文件重現問題，然後比較當時的 DocService 和 Nextcloud 日誌。在 Linux 系統中，ONLYOFFICE 日誌位於 `/etc/logs/` 目錄下/var/log/onlyoffice/documentserver/；在 Docker 環境中，請檢查容器日誌或掛載的日誌目錄。 Nextcloud 的預設日誌檔案位於nextcloud.log其資料目錄中，除非 ` /etc/logs/`log_type或logfile`/etc/logs/` 進行了更改。

• 301、302 或 308：回呼 URL 重新導向，通常在 HTTP/HTTPS 或主機名稱之間進行。
• 逾時或 DNS 錯誤：文檔伺服器無法解析或存取 URL。
• 403 或 404：代理程式、存取規則、路徑重寫或主機設定可能會拒絕請求。
• Nextcloud 儲存異常：回呼已到達；請檢查配額、權限、儲存健康狀況或鎖定。

3. 當回呼重定向時，修正 URL 或代理路由。

在 Nextcloud 中，開啟「設定」>「管理」>「ONLYOFFICE」。確認 ONLYOFFICE Docs 的公共位址是使用者瀏覽器應該載入的 URL。如果兩個伺服器無法透過公用位址相互訪問，請設定文件中說明的內部欄位：伺服器內部請求的 ONLYOFFICE Docs 位址和ONLYOFFICE Docs 內部請求的伺服器位址。第一個位址必須能夠從 Nextcloud 存取文件伺服器；第二個位址必須能夠從文件伺服器存取 Nextcloud。

在 Mina 的假設配置中，回呼函數使用http://cloud.example.comHTTPS 並重定向到 HTTPS。請直接設定最終的 HTTPS 位址，然後確保 DNS、防火牆規則和憑證信任允許文件伺服器存取該位址。代理程式應將回呼函數傳遞給 Nextcloud，而不重定向其協定、主機名稱或路徑。範例主機名稱不適用於實際安裝。

ONLYOFFICE 的連線檢查可以幫助驗證已配置的服務位址：

sudo -u www-data php occ onlyoffice:documentserver --check

請使用對應的 Web 伺服器帳戶，從 Nextcloud 目錄執行此命令。檢查成功並不代表回呼 POST 請求有效。手動發送 HEAD 請求或存取相同主機名稱的瀏覽器頁面也無法證明這一點。

4. 順著證據追蹤到 Nextcloud 存儲

如果回呼到達 Nextcloud 但檔案仍然沒有更新，請檢查 Nextcloud 日誌中是否有符合的請求。確認使用者擁有編輯權限、儲存掛載點可用、帳戶未超出配額，且資料磁碟區有足夠的可用空間和 inode。如果問題影響共用文件，請詢問是否有其他使用者或同步用戶端同時修改該文件，然後使用私有資料夾中的副本進行測試。

Nextcloud 的事務性檔案鎖定機制用於協調寫入作業；請勿將其作為臨時解決方案而停用。如果日誌指向鎖定或資料庫錯誤，請檢查鎖定後端以及 Redis 或 Valkey 服務。請勿刪除oc_file_locks行或鎖定文件，這可能會中斷正在進行的寫入操作。

如果標準資料夾測試通過，但外部儲存的檔案測試失敗，請檢查該掛載點的可用性和驗證模式。 ONLYOFFICE 文件中記錄了某些外部儲存模式的限制；在隔離該掛載點之前，請勿變更憑證。

5. 驗證完整的保存路徑

更改一項設定後，在一個小的測試文件中進行一次單獨的編輯，等待儲存完成，然後從 Nextcloud 關閉並重新開啟該文件。確認編輯內容已儲存，且對應的日誌中沒有重定向、連線失敗或儲存異常。

如果測試成功但原始檔案仍然失敗，請檢查其權限、外部掛載或並發編輯情況。如果所有回呼都失敗，請保留本機副本，並使用時間戳記、HTTP 狀態碼、版本號和已脫敏的日誌進行升級。請對 JWT、Cookie、簽名 URL 和個人檔案名稱進行編輯。

這些步驟旨在解決導致保存錯誤的常見回呼、路由和儲存問題。具體的修復方案取決於日誌中的第一個故障點；僅憑連接檢查成功並不能保證整個保存流程正常。

官方參考資料

• ONLYOFFICE Nextcloud 整合：伺服器位址、回呼流程和連線檢查
• ONLYOFFICE Docs 故障排除：保存錯誤和回呼可達性
• Nextcloud 35 管理手冊：事務性文件鎖定
• Nextcloud 管理手冊：日誌配置

文件已於 2026 年 10 月 9 日審核。連接器欄位和日誌目標位置可能會因已安裝的應用程式版本和部署配置而異。