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.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 不兼容导致无法加载。
解决方案：
安装谷歌浏览器，重新访问即可。
7. 一键升级后，打开定时任务显示不存在
问题描述：
使用 FineDataLink一键升级 功能升级成功后，打开任意定时任务报错：任务不存在，无法获取文件；但 dpworks 文件夹下是有任务文件的。
解决方案：
由于 FDL 工程安装在 Linux 中，重启工程时需要使用 root 账号进行重启。
8. 升级后报错：integrity constraint violation: unique constraint or index violation
问题描述：
4.0 升级后启动失败，报错：integrity constraint violation: unique constraint or index violation; UK_PUCN6HA970X5RLCJ7N9XL9UD4 table: FINE_DP_SERVICE_TASK
原因分析：
工程用的内置数据库，内置 FineDB 数据库库有缺陷，迁移到外接数据库即可。详情请参见：配置外接数据库
上一篇：容器化部署常见问题
