跳到主要内容

Windows 版 ONLYOFFICE 文档故障排除

联系支持团队之前：收集诊断信息​

如果您遇到的问题未在下文中提及，请在联系 ONLYOFFICE 支持团队之前收集以下信息：

Windows：

  • 日志目录：%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\
  • 已安装的版本：在控制面板的“程序和功能”中查看

使用问题​

问： 停止 ONLYOFFICE 文档时发生了数据丢失。如何防止数据丢失？

答： 由于运行机制的特点，ONLYOFFICE 文档只有在所有编辑过文档的用户都关闭该文档后才会保存它。为避免数据丢失，在应用程序更新、服务器重启等需要停止 ONLYOFFICE 文档的情况下，您必须强制断开 ONLYOFFICE 文档用户的连接。为此，请在安装了 ONLYOFFICE 文档的服务器上执行以下脚本：

%ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat
备注

执行该脚本可能需要较长时间（最多 5 分钟）。

问： ONLYOFFICE 文档服务无法启动。我该怎么办？

答： 打开服务面板（services.msc），检查 ds-docservice 和 ds-converter 的状态。如果任一服务已停止，请尝试手动启动。常见原因包括：

  • 内存不足（建议至少 4 GB 内存）。

  • 端口 80 已被其他应用程序占用。请停止该应用程序，或使用其他端口重新安装 ONLYOFFICE 文档：

    onlyoffice-documentserver.exe /DS_PORT=<PORT_NUMBER>

  • 查看 %ProgramFiles%\ONLYOFFICE\DocumentServer\Log\ 中的日志以获取更具体的错误信息。

问： 将 ONLYOFFICE 文档与我的平台集成后，JWT 身份验证失败。如何解决？

答： 确认 ONLYOFFICE 文档中配置的 JWT 密钥与平台连接器设置中配置的密钥完全一致。还要检查 JWT 标头名称是否一致（默认为 "Authorization"）。要查看当前密钥，请在文本编辑器中打开以下文件：

%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

查找 services.CoAuthoring.secret.session.string 处的值。常见错误：

  • 密钥值的开头或结尾有空格。
  • 使用默认的随机密钥，而没有设置自定义密钥。

问： 文档转换失败（例如，打开 DOC、XLS 或 PPT 文件时显示错误）。我该怎么办？

答： 检查转换器日志中的错误：

%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\

常见原因包括磁盘空间不足和缺少字体。

问： ONLYOFFICE 文档占用大量内存。这正常吗？

答： 内存使用量随打开的文档数和并发用户数而增加。对于有几十个活跃用户的服务器，2–4 GB 的内存使用量是正常的。如果内存使用量异常高，请检查以下目录中是否有卡住或被遗忘的文档：

%ProgramData%\ONLYOFFICE\DocumentServer\App_Data\cache\files\forgotten\

企业版和开发者版问题​

问： 我看到 "License expired"（许可证已过期）警告。我该怎么办？

答： 您的 license.lic 文件已过期。请联系 sales@onlyoffice.com 续订许可证。收到新文件后，替换数据目录中旧的 license.lic 文件并重启 ONLYOFFICE 文档。

问： 我无法访问管理面板。我该怎么办？

答： 如果您尚未设置管理面板，请按照管理面板设置指南进行操作。如果您忘记了管理员密码，请从 runtime.json 中删除 passwordHash 条目并重启，系统将生成新的引导代码。