onlyoffice打印异常需检查wopi配置、pdf模板路径、jwt签名、浏览器打印参数及pdf编辑器启用状态。依次确认local.json中wopi.enable为true、host有效、htmltemplate路径正确、jwt配置匹配、browserprint设为true，并确保pdfedit包含"pdf"且pdf.print为true。
如果您在使用 OnlyOffice 文档编辑器时无法正常打印文档，或打印内容缺失、格式错乱、无法调用本地打印机，则可能是由于打印服务未正确配置或相关参数缺失。以下是解决此问题的步骤：
一、检查并启用 WOPI 打印支持
OnlyOffice 的打印功能依赖于 WOPI 协议与集成平台（如 Nextcloud、SharePoint）协同工作。若 WOPI 未启用，浏览器端将无法触发完整打印流程，仅能导出为 PDF 后手动打印。
1、打开 ONLYOFFICE 文档服务器配置文件 local.json，路径为：
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json（Windows）或 /etc/onlyoffice/documentserver/local.json（Linux）。
2、在 wopi 对象下确认存在并启用以下参数：
3、将 "enable": true 设置为 true；
4、确保 "host" 字段填写为集成平台的实际主机地址（例如 "https://nextcloud.example.com"），不可为空或留为默认空字符串。
5、保存文件后，执行服务重启命令：
systemctl restart ds-*（Linux RPM/DEB 包安装）或 docker restart
二、验证并配置 PDF 打印模板路径
OnlyOffice 使用内置 PDF 渲染引擎生成可打印视图，该过程需正确指向 WOPI HTML 模板路径。路径错误将导致打印按钮灰显或点击无响应。
1、在 same local.json 文件的 wopi 节点中，定位 "htmlTemplate" 字段。
2、将其值设为绝对路径形式："../../web-apps/apps/api/wopi"（默认值，不建议修改）；
3、若文档服务器以非标准路径部署（如自定义 web-apps 目录），需同步更新该路径，确保其指向实际存在的 wopi/index.html 文件所在目录。
4、检查文件系统权限：确认运行文档服务器的用户（如 onlyoffice 或 ds 用户）对该路径具有读取权限。
三、启用并校验 JWT 签名与 token 传递
当 OnlyOffice 集成至第三方平台时，打印请求需携带有效 JWT token 进行身份与权限校验。缺少或无效 token 将中断 WOPI 打印回调流程。
1、确认文档服务器启动时已传入 JWT_SECRET 环境变量（Docker 部署需包含 -e JWT_SECRET=my_secret_key）；
2、检查集成平台（如 Nextcloud ONLYOFFICE 插件）后台设置中，JWT 密钥 是否与文档服务器一致；
3、在前端调用 DocEditor 初始化时，确保 config 对象中包含 token 字段，且其值为由集成平台签发的有效 JWT；
4、若使用测试环境且暂不启用 JWT，可在 local.json 中显式设置："jwt": { "inbox": { "enable": false }, "outbox": { "enable": false } }，但生产环境严禁此操作。
四、调整客户端浏览器打印行为参数
部分浏览器（尤其是 Chromium 内核新版）对跨域 iframe 打印施加限制，可能导致 OnlyOffice 内嵌编辑器中点击“打印”仅弹出空白预览页。需通过配置强制启用原生打印通道。
1、进入文档服务器配置文件 local.json 的 services.CoAuthoring 节点；
2、添加或修改子字段："browserPrint": true；
3、若仍无效，进一步设置："forceBrowserPrint": true，该参数将绕过 ONLYOFFICE 内部 PDF 渲染，直接调用浏览器原生 print() 方法；
4、重启文档服务器使变更生效。
五、验证并启用 PDF 编辑器的打印能力
对于 PDF 类型文档，OnlyOffice 使用专用 pdfeditor 组件处理打印。若该组件未启用或支持类型受限，PDF 文件将无法触发打印界面。
1、在 local.json 的 wopi 节点中，检查 "pdfView" 数组是否包含目标扩展名，例如：["pdf", "djvu", "xps", "oxps"]；
2、确认 "pdfEdit" 数组至少包含 "pdf"，否则 PDF 文件可能被降级为只读视图，禁用打印入口；
3、检查 services.CoAuthoring.editor.config 下是否存在 "pdf": { "print": true } 显式启用项；
4、若使用 Docker 部署，确保容器启动时挂载了完整 web-apps 资源，特别是 /usr/share/nginx/html/web-apps/apps/pdfeditor/ 目录存在且非空。
