问题描述

在使用可道云对接 OnlyOffice 进行在线文档编辑时，部分用户可能会遇到如下错误提示：
“文档安全令牌的格式不正确”
问题截图
该问题通常出现在 OnlyOffice 版本升级至 7.2 及以上后。从 7.2 版本开始，OnlyOffice 默认启用了 JWT（JSON Web Token）认证机制，以增强文档服务的安全性。

然而，目前可道云官方提供的 OnlyOffice 对接插件 并未支持 JWT 密钥配置功能。由于双方在安全验证上不匹配，导致文档无法正常加载和编辑。

解决方案

要解决此兼容性问题，最直接有效的方法是：
在部署 OnlyOffice 服务时，关闭 JWT 认证功能。
操作步骤（以宝塔面板 Docker 部署为例）

1. 进入容器模板编辑界面

在宝塔面板中找到 OnlyOffice 服务，点击“编辑模板”，选择“自定义”模式。

编辑模板

2. 添加环境变量

在 environment 区域添加以下配置，用于禁用 JWT 验证：

environment:
JWT_ENABLED=false

✅ 确保该配置项正确写入服务的启动环境中。

添加环境变量

3. 启动服务

保存配置并创建 OnlyOffice 容器

验证结果

完成上述配置后，重新在可道云中打开文档，即可正常加载并进行在线编辑。

文档正常打开

补充说明

此方法通过关闭 JWT 来实现兼容性，适用于对安全性要求不高、内网使用的场景。
若需启用 JWT 提高安全性，建议寻找支持 JWT 配置的第三方插件，或自行开发适配。
建议关注可道云官方后续是否更新插件以支持 JWT 配置。

✅ 总结：只需在部署时设置 JWT_ENABLED=false，即可快速解决 OnlyOffice 7.2+ 与可道云对接时的令牌错误问题。