检测 OnlyOffice 服务是否安装成功
首先访问 OnlyOffice 首页,如下图:
出现上图仍旧不能说明你的 OnlyOffice 服务已经成功安装,我们需要启动 OnlyOffice 服务测试用例来检测,可以看到上图出现了两条命令,第一条命令是用来启动测试用例服务的,我们只需要在后台执行该命令即可,Windows环境是以管理员身份运行Windows PowerShell输入net start DsExampleSvc
即可运行了。
启动完成后,点击下方按钮即可进入主页,如果没有启动或启动失败,点击链接则进入报错页面,如下图:
成功启动如下图:
接下来可以在这个页面来创建或者上传文件,如果功能正常,则说明 OnlyOffice 在安装时是没有问题的。
打开文档后一直显示加载中或空白页面
解决方法一:
检测您的rabbitmq是否运行,出现下图效果表示正在运行。
解决方法二:
可能是在Dzz配置的 OnlyOffice 服务器地址不正确,登录Dzz后台—应用市场—onlyoffice插件设置,检查OnlyOffice Document Server API地址是否正确,检查方法看onlyoffice。
解决方法三:
连接到PostgreSQL服务器检查数据库是否可以访问。
解决方法四:
OnlyOffice要想正常使用的先决条件是要安装并配置好以下组件:
Erlang
RabbitMQ
Redis
PostgreSQL
大文件下载到一定大小之后,又从0开始下载
可能是 nginx 缓存导致的超时,解决办法是关闭 nginx 缓存。 在 nginx.conf 配置文件中的 http 节点下,配置如下属性:
proxy_request_buffering off; proxy_buffering off;
下载失败(Download failed)
打开文档显示“下载失败”的提示框
原因分析与解决方法
文件链接问题
请检查document.url链接中指定的文件链接是否正确,检查方法看onlyoffice。确保可以从文档编辑服务访问该链接,并且该链接能够正常访问(即不会出现404错误)。
查看当前页面的源码,访问url地址后能否正常显示文档或下载文档,只要不能正常显示文档或下载文档就是文件链接问题。
Onlyoffice本身问题
访问OnlyOffice Document Server API地址,新建文档试试,如果也提示下载失败(Download failed),就是Onlyoffice本身问题,检查onlyoffice是否搭建成功和相关服务是否正常运行。
这份文件无法保存。请检查连接设置或联系您的管理员。
当遇到“这份文件无法保存。请检查连接设置或联系您的管理员。”、"无法保存(Could not be saved)"、“该文档无法保存”错误时,可能的原因和解决方法。
原因分析与解决方法
网络连接问题
检查网络连接是否正常。
确保Dzz与Onlyoffice互通,检查方法看onlyoffice。
确保防火墙或安全软件未阻止应用程序访问网络。
尝试关闭防火墙或安全软件,然后重新保存文件。
权限问题
检查当前用户是否有足够的权限保存文件。
确认Dzz平台是否关闭,关闭时无法保存文件。
存储位置问题
确保保存位置存在并且可写
软件问题
检查Dzz与onlyoffice插件是否为最新版本
尝试重新搭建Onlyoffice
文件损坏
检查文件是否损坏
尝试重新创建或从备份中恢复文件
php版本兼容问题
如果是php5.6,可以换成其他的php版本。建议使用php7。或者修改php.ini文件,修改后重启服务器。
always_populate_raw_post_data = -1
文档安全令牌未正确形成。请与您的文件服务器管理员联系
当遇到“文档安全令牌未正确形成。请与您的文件服务器管理员联系”、"令牌无效(Invalid token)"错误时,可能的原因和解决方法。
原因分析与解决方法
自Onlyoffice7.2版本起,默认启用了JWT,即加入了密钥验证机制。客户端和服务器端必须使用相同的密钥才能进行通信。然而,DzzOffice 官方onlyoffice插件还未适配,其中一个含有密钥,另一个则没有,因此无法实现互通。
解决方案一:
更新插件。官方版还不知道什么时候更新,但您可以使用我二次开发的插件,然后在插件后台填写密钥即可,如果还是提示“文档安全令牌未正确形成”,则表示密钥填写不正确。
解决方案二:
关闭令牌并重启服务,这样就不会再出现“文档安全令牌未正确形成”的提示。
文件版本已更改。页面将被重新加载
在遇到“文件版本已更改。页面将被重新加载”、“文件版本已更改(The file version has been changed)”等错误提示,以及在线编辑内容未能真正保存到服务器原始文件中,或在重新打开时仍显示为空等情况时,可能的原因和解决方法。
原因分析与解决方法
该问题源于file_get_contents
函数配置不当,由于未能正常启用该函数,导致在保存回调过程中内容始终无法写入。
解决方法
检测PHP配置中是否开启了 extension=php_openssl.dll
和 allow_url_fopen=on
, 检测是否禁用了file_get_contents