OnlyOffice 报错排查流程总结

检测 OnlyOffice 服务是否安装成功

首先访问 OnlyOffice 服务地址，如下图：

出现上图仍旧不能说明你的 OnlyOffice 服务已经成功安装，我们需要启动 OnlyOffice 服务测试用例来检测，可以看到上图出现了两条命令，第一条命令是用来启动测试用例服务的，我们只需要在后台执行该命令即可，Windows环境是以管理员身份运行Windows PowerShell输入net start DsExampleSvc即可运行了。

启动完成后，点击下方按钮即可进入主页，如果没有启动或启动失败，点击链接则进入报错页面，如下图：

成功启动如下图：

接下来可以在这个页面来创建或者上传文件，如果功能正常，则说明 OnlyOffice 在安装时是没有问题的。

打开文档后一直显示加载中或空白页面

解决方法一：

检测您的rabbitmq是否运行，出现下图效果表示正在运行。

Windows环境的可以验证rabbitmq是否安装成功
命令：rabbitmqctl status

解决方法二：

可能是在Dzz配置的 OnlyOffice 服务器地址不正确，登录Dzz后台—应用市场—onlyoffice插件设置，检查OnlyOffice Document Server API地址是否正确。

解决方法三：

连接到PostgreSQL服务器检查数据库是否可以访问。

解决方法四：

OnlyOffice要想正常使用的先决条件是要安装并配置好以下组件:

大文件下载到一定大小之后，又从0开始下载

可能是 nginx 缓存导致的超时，解决办法是关闭 nginx 缓存。在 nginx.conf 配置文件中的 http 节点下，配置如下属性：

proxy_request_buffering off;
proxy_buffering off;

下载失败(Download failed)

打开文档显示“下载失败”的提示框或在编辑器加载过程中会显示"下载失败"消息。

这是因为文档编辑服务无法上传文件进行编辑。

需要检查 document.url 中指定的文件的链接是否正确。该链接必须可以从文档编辑服务访问。

原因分析与解决方法

确认Dzz平台是否关闭，关闭时无法下载文件。

文件链接问题

请检查document.url链接中指定的文件链接是否正确。确保可以从文档编辑服务访问该链接，并且该链接能够正常访问（即不会出现404错误）。
查看当前页面的源码，访问url地址后能否正常显示文档或下载文档，只要不能正常显示文档或下载文档就是文件链接问题。需使用未登录Dzz账号的浏览器进行访问url地址。

Onlyoffice本身问题

访问OnlyOffice Document Server API地址，新建文档试试，如果也提示下载失败(Download failed)，就是Onlyoffice本身问题，检查onlyoffice是否搭建成功和相关服务是否正常运行。

部分情况下，OnlyOffice服务可能不允许私有IP地址访问。若日志中出现相关错误如不能下载，可编辑Docker容器中的配置文件 /etc/onlyoffice/documentserver/default.json ，将request-filtering-agent下的allowPrivateIPAddress和allowMetaIPAddress设置为true，修改后重启OnlyOffice容器。

其他问题

可以参考下：https://github.com/zyx0814/dzzoffice/issues/89

这份文件无法保存。请检查连接设置或联系您的管理员。

当遇到“这份文件无法保存。请检查连接设置或联系您的管理员。”、"无法保存(Could not be saved)"、“该文档无法保存”错误时，可能的原因和解决方法。

这是因为文档编辑服务无法连接到 editorConfig.callbackUrl 地址的文档存储服务。
需要检查回调处理程序是否正常工作。文档存储服务必须返回 {"error": 0} 作为响应。

原因分析与解决方法

网络连接问题

检查网络连接是否正常。

确保Dzz与Onlyoffice互通。

确保防火墙或安全软件未阻止应用程序访问网络。

尝试关闭防火墙或安全软件，然后重新保存文件。

权限问题

检查当前用户是否有足够的权限访问插件。

确认Dzz平台是否关闭，关闭时无法保存文件。

存储位置问题

确保保存位置存在并且可写

软件问题

检查Dzz与onlyoffice插件是否为最新版本

访问OnlyOffice Document Server API地址，新建文档试试，如果也提示无法保存，就是Onlyoffice本身问题，检查onlyoffice是否搭建成功和相关服务是否正常运行。

尝试重新搭建OnlyOffice

文件损坏

检查文件是否损坏

尝试重新创建或从备份中恢复文件

php版本兼容问题

如果是php5.6，可以换成其他的php版本。建议使用php7。或者修改php.ini文件，修改后重启服务器。

always_populate_raw_post_data = -1

文档安全令牌未正确形成。请与您的文件服务器管理员联系

当遇到“文档安全令牌未正确形成。请与您的文件服务器管理员联系”、"令牌无效(Invalid token)"错误时，可能的原因和解决方法。

原因分析与解决方法

自OnlyOffice7.2版本起，默认启用了JWT，即加入了密钥验证机制。客户端和服务器端必须使用相同的密钥才能进行通信。

解决方案一：

在插件后台填写密钥即可，如果还是提示“文档安全令牌未正确形成”，则表示密钥填写不正确。

解决方案二：

关闭令牌并重启服务，这样就不会再出现“文档安全令牌未正确形成”的提示。

文件版本已更改。页面将被重新加载

在遇到“文件版本已更改。页面将被重新加载”、“文件版本已更改(The file version has been changed)”等错误提示，以及在线编辑内容未能真正保存到服务器原始文件中，或在重新打开时仍显示为空等情况时，可能的原因和解决方法。

原因分析与解决方法

该问题源于file_get_contents函数配置不当，由于未能正常启用该函数，导致在保存回调过程中内容始终无法写入。
检测PHP配置中是否开启了 extension=php_openssl.dll 和 allow_url_fopen=on ，检测是否禁用了file_get_contents

表格无法插入列或插入列异常

这是因为onlyoffice编辑插件默认关闭了过滤器，需要开启才能插入列。

文件大小超出了服务器设置的限制

解决方法

修改配置文件default.json
配置文件位置：
Linux: /etc/onlyoffice/documentserver/default.json
Windows: %ProgramFiles%\ONLYOFFICE\DocumentServer\config\default.json

OnlyOffice 报错排查流程总结

检测 OnlyOffice 服务是否安装成功#

打开文档后一直显示加载中或空白页面#

解决方法一：#

解决方法二：#

解决方法三：#

解决方法四：#

大文件下载到一定大小之后，又从0开始下载#

下载失败(Download failed)#

原因分析与解决方法#

确认Dzz平台是否关闭，关闭时无法下载文件。#

文件链接问题#

Onlyoffice本身问题#

其他问题#

这份文件无法保存。请检查连接设置或联系您的管理员。#

原因分析与解决方法#

网络连接问题#

权限问题#

存储位置问题#

软件问题#

文件损坏#

php版本兼容问题#

文档安全令牌未正确形成。请与您的文件服务器管理员联系#

原因分析与解决方法#

解决方案一：#

解决方案二：#

文件版本已更改。页面将被重新加载#

原因分析与解决方法#

表格无法插入列或插入列异常#

文件大小超出了服务器设置的限制#

解决方法#

检测 OnlyOffice 服务是否安装成功

打开文档后一直显示加载中或空白页面

解决方法一：

解决方法二：

解决方法三：

解决方法四：

大文件下载到一定大小之后，又从0开始下载

下载失败(Download failed)

原因分析与解决方法

确认Dzz平台是否关闭，关闭时无法下载文件。

文件链接问题

Onlyoffice本身问题

其他问题

这份文件无法保存。请检查连接设置或联系您的管理员。

原因分析与解决方法

网络连接问题

权限问题

存储位置问题

软件问题

文件损坏

php版本兼容问题

文档安全令牌未正确形成。请与您的文件服务器管理员联系

原因分析与解决方法

解决方案一：

解决方案二：

文件版本已更改。页面将被重新加载

原因分析与解决方法

表格无法插入列或插入列异常

文件大小超出了服务器设置的限制

解决方法