OnlyOffice 报错排查流程总结

1. 检测 OnlyOffice 服务是否安装成功

首先访问 OnlyOffice 首页，如下图：

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

即可运行了。

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

成功启动如下图：

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

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

解决方法一：

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

解决方法二：

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

是否正确，检查方法看

。

解决方法三：

连接到

检查数据库是否可以访问

解决方法四：

要想正常使用需要的

下载并安装以下组件:

• Erlang
• RabbitMQ
• Redis
• PostgreSQL

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

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

proxy_request_buffering off;
proxy_buffering off;

1. 下载失败(Download failed)

打开文档显示“下载失败”的提示框

原因分析与解决方法

1. 文件链接问题

请检查document.url链接中指定的文件链接是否正确，检查方法看

。确保可以从文档编辑服务访问该链接，并且该链接能够正常访问（即不会出现404错误）。查看当前页面的源码，访问url地址后能否正常显示文档或下载文档，只要不能正常显示文档或下载文档就是

。

1. Onlyoffice本身问题

访问

地址，新建文档试试，如果也提示

，就是Onlyoffice本身问题，检查onlyoffice是否搭建成功和相关服务是否正常运行。

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

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

原因分析与解决方法

1. 网络连接问题

• 检查网络连接是否正常。
• 确保Dzz与Onlyoffice互通，检查方法看onlyoffice。

• 确保防火墙或安全软件未阻止应用程序访问网络。
• 尝试关闭防火墙或安全软件，然后重新保存文件。

1. 权限问题

• 检查当前用户是否有足够的权限保存文件。
• 确认Dzz平台是否关闭，关闭时无法保存文件。

1. 存储位置问题

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

1. 软件问题

• 检查Dzz与onlyoffice插件是否为最新版本
• 尝试重新搭建Onlyoffice

1. 文件损坏

• 检查文件是否损坏
• 尝试重新创建或从备份中恢复文件

1. php版本兼容问题

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

always_populate_raw_post_data = -1

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

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

原因分析与解决方法

自Onlyoffice7.2版本起，默认启用了JWT，即加入了密钥验证机制。客户端和服务器端必须使用相同的密钥才能进行通信。然而，DzzOffice 官方onlyoffice插件还未适配，其中一个含有密钥，另一个则没有，因此无法实现互通。

解决方案一：

更新插件。官方版还不知道什么时候更新，但您可以使用我二次开发的插件，然后在插件后台填写密钥即可，如果还是提示“文档安全令牌未正确形成”，则表示密钥填写不正确。

解决方案二：

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

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

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

原因分析与解决方法

该问题源于

函数配置不当，由于未能正常启用该函数，导致在保存回调过程中内容始终无法写入。

解决方法

检测PHP配置中是否开启了

和

， 检测是否禁用了