1. 概述
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineDataLink在不断地更新迭代。
若需要体验新产品功能或者修复之前版本中存在的一些问题，客户需要将FDL升级到当前最新版本。
本文简单介绍升级后常见的问题和解决方案。
2. 数据转换报错
问题描述：
数据转换报错：Spark执行错误
错误日志：java.lang.NoSuchMethodError: com.fasterxml.jackson.databind.ObjectMapper.addMixIn
原因分析：
若用户使用过「数据管道」功能，工程从低版本升级到4.0.15及之后，需要将之前放置在webapps/webroot/web-inf/lib目录中的Kafka驱动包删除。
解决方案：
请手动删除webapps/webroot/web-inf/lib目录下的Kafka驱动包，包括：
objenesis-2.5.1.jar
mysql-binlog-connector-java-0.25.6.jar
kafka-clients-2.8.1.jar
javassist-3.21.0-GA.jar
jackson-core-2.8.8.jar
fst-2.57.jar
3. 数据平台尚未启动成功，请稍候
问题描述：
用户登录FineDataLink后，出现弹窗报错「数据平台尚未启动成功，请稍候」，如下图所示：
无法正常使用以及会造成权限错乱等异常情况。
原因分析：
不同部署方式、升级到部分版本，由于功能出现变更，应当删除/新增一些JAR包。
解决方案：
排查是否存在以下JAR包问题并解决。
| 部署方式 | 升级到的版本 | JAR包问题 |
|---|---|---|
| 通用部署 | 配套平台11.0.9及以上 | 平台11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能 因此FineDataLink配套平台升级至11.0.9及之后版本，需要手动删除webapps/webroot/WEB-INF/lib下netty相关jar包 |
| 集成部署 | FDL4.0.18及以上 | 集成FineReport，需要删除fdl-piepline-4.0.jar |
| 集成部署 | FDL4.0.14之前 | 集成FineReport，需要新增一个fine-bi-engine-third-5.1.jar |
| 集成部署 | FDL4.0.14及以上 | 集成FineReport，需要新增一个fine-bi-engine-third-6.0.jar |
| 独立部署 | FDL4.0.6及以上 | 删除fine-data-platform-11.0.jar |
| 独立部署 | FDL4.0.14.2及以上 | fine-bi-engine-third-5.1.jar和fine-bi-engine-third-6.0.jar互相冲突，删除fine-bi-engine-third-5.1.jar |
| 独立部署 | - | 删除fdl-bi-extension-4.0.jar |
3. 重启步骤不规范
问题描述：
独立部署升级后
1）中文内容不正常显示为英文。
2）调度无法正常执行
原因分析：
升级时，未规范重启服务器。进程未全部关闭就重启了服务器，导致出现了服务器内部错误。
解决方案：
请参考 FDL独立部署升级 进行规范的重启操作：
使用 ps -ef|grep tomcat查看进程，并执行 kill -9 进程号。例如进程号为 20976，则执行 kill -9 20976。
然后进入文件解压目录%Tomcat_HOME%\tomcat-win64\bin下，执行命令 nohup ./startup.sh & ， 即可重启 Tomcat 服务器。
4. 数据开发模块丢失
问题描述：
升级到 4.0.18 版本后，FineDataLink 系统内数据开发模块丢失，如下图所示：
原因分析：
4.0.18 及之后版本的 FineDataLink 注册逻辑发生变动，lic 文件中缺少基础数据源功能点，会导致数据开发入口丢失。
解决方案：
请联系商务进行处理。
5. 读取BI自助数据集报错INTERNAL
问题描述：
使用FineDataLink读取BI公共数据中的自助数据集时报错：
原因分析：
FineBI 特定 JAR 未更新到最新版。
解决方案：
确认工程的JAR包时间，并向技术支持获取对应JAR包。技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
1）若 JAR 包日期在 2023.08.09 之前，请联系技术支持先获取 2023.08.09 及以上版本的 JAR 包，升级到该版本。
2）再联系技术支持获取FineBI特供的功能 JAR 包，将技术支持处获取的JAR包上传至FineBI的%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目录下。
6. 搜狗浏览器打开FDL看不到数据开发、管道等模块
问题描述：
搜狗浏览器打开 FDL 看不到数据开发、管道等模块。
原因分析：
某些 JS 不兼容导致无法加载。
解决方案：
安装谷歌浏览器，重新访问即可。
