OnlyOffice 報錯排查流程總結(jié)

為了獲取更多最新內(nèi)容及功能更新，請直接訪問我們的首頁以查看DzzOffice筆記的最新地址。檢測 OnlyOffice 服務(wù)是否安裝成功

首先訪問 OnlyOffice 首頁，如下圖：

出現(xiàn)上圖仍舊不能說明你的 OnlyOffice 服務(wù)已經(jīng)成功安裝，我們需要啟動 OnlyOffice 服務(wù)測試用例來檢測，可以看到上圖出現(xiàn)了兩條命令，第一條命令是用來啟動測試用例服務(wù)的，我們只需要在后臺執(zhí)行該命令即可，Windows環(huán)境是以管理員身份運行Windows PowerShell輸入

即可運行了。

啟動完成后，點擊下方按鈕即可進(jìn)入主頁，如果沒有啟動或啟動失敗，點擊鏈接則進(jìn)入報錯頁面，如下圖：

成功啟動如下圖：

接下來可以在這個頁面來創(chuàng)建或者上傳文件，如果功能正常，則說明 OnlyOffice 在安裝時是沒有問題的。

1. 打開文檔后一直顯示加載中或空白頁面

解決方法一：

檢測您的rabbitmq是否運行，出現(xiàn)下圖效果表示正在運行。

解決方法二：

可能是在Dzz配置的 OnlyOffice 服務(wù)器地址不正確，登錄Dzz后臺—應(yīng)用市場—onlyoffice插件設(shè)置，檢查

是否正確，檢查方法看

。

解決方法三：

連接到

檢查數(shù)據(jù)庫是否可以訪問

解決方法四：

要想正常使用需要的

下載并安裝以下組件:

• Erlang
• RabbitMQ
• Redis
• PostgreSQL

1. 大文件下載到一定大小之后，又從0開始下載

可能是 nginx 緩存導(dǎo)致的超時，解決辦法是關(guān)閉 nginx 緩存。 在 nginx.conf 配置文件中的 http 節(jié)點下，配置如下屬性：

proxy_request_buffering off;
proxy_buffering off;

1. 下載失敗(Download failed)

打開文檔顯示“下載失敗”的提示框

原因分析與解決方法

1. 文件鏈接問題

請檢查document.url鏈接中指定的文件鏈接是否正確，檢查方法看

。確保可以從文檔編輯服務(wù)訪問該鏈接，并且該鏈接能夠正常訪問（即不會出現(xiàn)404錯誤）。查看當(dāng)前頁面的源碼，訪問url地址后能否正常顯示文檔或下載文檔，只要不能正常顯示文檔或下載文檔就是

。

1. Onlyoffice本身問題

訪問

地址，新建文檔試試，如果也提示

，就是Onlyoffice本身問題，檢查onlyoffice是否搭建成功和相關(guān)服務(wù)是否正常運行。

1. 這份文件無法保存。請檢查連接設(shè)置或聯(lián)系您的管理員。

當(dāng)遇到“這份文件無法保存。請檢查連接設(shè)置或聯(lián)系您的管理員?！?、"無法保存(Could not be saved)"、“該文檔無法保存”錯誤時，可能的原因和解決方法。

原因分析與解決方法

1. 網(wǎng)絡(luò)連接問題

• 檢查網(wǎng)絡(luò)連接是否正常。
• 確保Dzz與Onlyoffice互通，檢查方法看onlyoffice。

• 確保防火墻或安全軟件未阻止應(yīng)用程序訪問網(wǎng)絡(luò)。
• 嘗試關(guān)閉防火墻或安全軟件，然后重新保存文件。

1. 權(quán)限問題

• 檢查當(dāng)前用戶是否有足夠的權(quán)限保存文件。
• 確認(rèn)Dzz平臺是否關(guān)閉，關(guān)閉時無法保存文件。

1. 存儲位置問題

• 確保保存位置存在并且可寫

1. 軟件問題

• 檢查Dzz與onlyoffice插件是否為最新版本
• 嘗試重新搭建Onlyoffice

1. 文件損壞

• 檢查文件是否損壞
• 嘗試重新創(chuàng)建或從備份中恢復(fù)文件

1. php版本兼容問題

如果是php5.6，可以換成其他的php版本。建議使用php7?；蛘咝薷膒hp.ini文件，修改后重啟服務(wù)器。

always_populate_raw_post_data = -1

1. 文檔安全令牌未正確形成。請與您的文件服務(wù)器管理員聯(lián)系

當(dāng)遇到“文檔安全令牌未正確形成。請與您的文件服務(wù)器管理員聯(lián)系”、"令牌無效(Invalid token)"錯誤時，可能的原因和解決方法。

原因分析與解決方法

自O(shè)nlyoffice7.2版本起，默認(rèn)啟用了JWT，即加入了密鑰驗證機(jī)制。客戶端和服務(wù)器端必須使用相同的密鑰才能進(jìn)行通信。然而，DzzOffice 官方onlyoffice插件還未適配，其中一個含有密鑰，另一個則沒有，因此無法實現(xiàn)互通。

解決方案一：

更新插件。官方版還不知道什么時候更新，但您可以使用我二次開發(fā)的插件，然后在插件后臺填寫密鑰即可，如果還是提示“文檔安全令牌未正確形成”，則表示密鑰填寫不正確。

解決方案二：

關(guān)閉令牌并重啟服務(wù)，這樣就不會再出現(xiàn)“文檔安全令牌未正確形成”的提示。

1. 文件版本已更改。頁面將被重新加載

在遇到“文件版本已更改。頁面將被重新加載”、“文件版本已更改(The file version has been changed)”等錯誤提示，以及在線編輯內(nèi)容未能真正保存到服務(wù)器原始文件中，或在重新打開時仍顯示為空等情況時，可能的原因和解決方法。

原因分析與解決方法

該問題源于

函數(shù)配置不當(dāng)，由于未能正常啟用該函數(shù)，導(dǎo)致在保存回調(diào)過程中內(nèi)容始終無法寫入。

解決方法

檢測PHP配置中是否開啟了

和

， 檢測是否禁用了