目录:
1. 概述编辑
本文主要汇总了小版本升级时的常见问题及解决方案。
1.1 排查思路
如果在线更新升级失败，可参考以下排查步骤进行排查：
1）根据上述外网地址，查看相关地址是否能正常连通。
2）是否有替换文件夹中文件的权限。
3）检查工程中是否有其他多余的jar，可备份后移除尝试。
4）设计器更新注意需要先切换工作目录会设计器目录。
2. 常见问题及解决方案编辑
2.1 JAR 包不匹配导致的异常
现象：点击图表不出现编辑界面或远程设计切换工作目录失败。
原因分析：仅更新了设计器端，没有更新服务端，造成远程设计 JAR 包不匹配。
解决方案：同步更新服务器端到同一版本
2.2 MAC 设计器更新后无法打开模板
原因分析：更新操作不对；mac版本的设计器更新的时候 注意一下 jxbrowser 的包，和 windows 的版本是有区分的，不要拿 windows 版本的去更换。
解决方案：更换 JAR 包
2.3 分辨率异常
原因分析：2019-12-11之后的 JAR 的启动动画不再使用 javaFx ，而插件界面使用 fx 实现，所以点开插件管理设计器会变小，分辨率也会改变，这个是 java8 的 bug 。
解决方案：禁用 dpi，请参考：Windows高分屏下设计器显示问题 。
2.4 设计器卡死
原因分析：
1）设计器卡死出现比较多为3月份的JAR，JAR 包 BUG 。
2）集群环境推送日志的时候也会打印日志，会造成一个递归的调用直到栈溢出。
3）mac版本的设计器，如果同时运行magnet ，会影响报表的性能，导致设计器卡死。
解决方案：
1）更新 JAR 包即可。
2）更新 JAR 到 2019-06 月份之后的版本。
3）禁用 magnet，或者把 magnet 对设计器禁用。
2.5 升级 JAR 后 tomcat 启动闪退
现象：后台报错：java.lang.ClassNotFoundException: com.fr.plugin.cloud.analytics.core.schedule.CollectExecutorJob
原因分析：云端运维插件解压安装影响。
解决方案：删除如图所示 2 个 update 文件夹，重启工程。
2.6 服务器手动更新后平台访问失败且无 catalina.out 日志
现象：服务器部署在 linux 上，手动更新 JAR 包到最新，重启服务器后平台会无法访问，利用备份回退 JAR 包是可以正常访问的；手动重新更换 JAR 包，但是还是访问失败；页面报错“网址拒绝了连接请求”，catalina.out 日志没有输出，catalina.log 为 0kb 。
原因分析：catalina.sh 文件被改过。
解决方案：更换正常的 catalina.sh 文件，重启工程。
2.7 升级后添加用户无法保存，且没有密码选项
现象：升级 JAR 版本之后添加用户有问题，没有密码选项，选择平台内认证保存不上。
原因分析：浏览器缓存导致的。
解决方案：清理浏览器缓存。