导入证书报错 “invalid character”?
- 问题现象:出现如上报错主要是
- 原因说明:当docs-mgr的MGR_TEST_ENABLE为true时,不允许使用【内部试用】授权
- 临时解决:手工修改docs-mgr的MGR_TEST_ENABLE为false;
- 关注:以上问题只会出现在文档中台极简版首版即release_opendoc_lite_v6.0.2205中;
跑版问题处理
为什么发生 “ 跑版 ”?
前提说明
- 首先明确一个前提。受限于产品定位和web端性能,文档中台不能保证所有的排版格式和WPS客户端完全兼容。对于发生“跑版现象”的特殊样张,我们的应对机制是,首先排查是否是字体原因;其次再将剩余问题作为「特殊样张」问题跟进,持续推动产研内部我们优化改进。
原因说明
- 跑版原因有很多情况,根据目前已有项目的反馈总结,一般包含如下几种:
字体安装不全导致跑版(大部分情况)
服务器负载过高导致的跑版(少部分)
浏览器不兼容问题引起跑版(少部分)
Microsoft Office 创建的文档在WPS打开产生的样式问题(极少部分)
不同场景的字体依赖说明
- 由于上述情况1即字体不全为绝大多数文档跑版的原因,故在此对不同场景下文档打开时的字体依赖情况做简要说明,进而当出现跑版问题或前端出现下载字体提示时,可自行参考排查:
场景 | 服务端字体 | 客户端本地字体(含浏览器缓存) | 备注 |
---|---|---|---|
普通预览&在线编辑 | × | √ | 纯前端逻辑,不依赖服务端字体 |
高清预览 | √ | √ | |
打印或导出PDF/图片 | √ | × | 纯内核排版,只依赖服务端字体 |
“×”表示不依赖,“√”表示依赖
如何解决跑版问题?
处理流程
步骤说明
步骤 1 :明确浏览器是否在兼容性范围内
- 对于不在兼容性范围内的无法提供技术支持。有关兼容性的内容可参考:兼容性参考文档。
步骤 2 :确认是否缺失字体
- 关键要明确,将对应场景中显示的字体与实际使用的字体对比,看是否一致。
- 获取文档中所有字体可参考: https://p.wpseco.cn/wiki/doc/624f9482c5d8eee5df4b0e6a
- 确认当前web端显示的字体:可通过开发者工具识别,参考如下:
常见问题排查思路?
步骤 1 :明确兼容性范围
明确操作系统、浏览器是否在兼容性范围内,对于不在兼容性范围内的无法提供技术支持
参见:兼容性参考文档 ,IE11仅能保证预览功能
步骤 2 :检查服务运行情况
检查文档中台的服务器负载是否正常、中间件和应用状态是否OK、是否存在异常POD
参见:基础运维参考文档
步骤 3 :使用中台自带demo
≥V6-0920版本才自带demo服务,参见:demo使用说明,确定中台DEMO是否可以正常处理,排查特殊样章因素
对于特殊样章类问题需要提供原始样章文件,以方便问题排查
步骤 4 :前端查看异常信息
浏览器F12打开开发者工具,查看console和network是否有异常信息
如下报错可以基本定位是文件信息回调接口异常导致,可结合后端日志进一步定位确认
步骤 5 :查看后台日志
查看后台日志,根据不同业务类型依次查看对应服务的日志
文档中台日志查看方法:https://p.wpseco.cn/wiki/doc/624e8745ecac68f1835c9e83
以文件信息回调异常为例,weboffice-apiserver和weboffice-cloudprovider分别有明显的文件信息回调接口报错
步骤 6 :排查回调接口报文
抓取网路包查看实际回调接口报文,是否遗漏必填字段,字段类型是否一致
文件下载地址在中台服务器是否能正常下载文件
save回调接口返回的version版本号是否已经递增处理
步骤 7 :明确当前版本信息,转工单处理
如果问题依旧无法定位,获取中台版本和WebOffice版本提交工单处理。
文档中台版本查看:登录文档中台服务器,进入kubewps容器,执行cat VERSION和 ls apps