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 資料庫庫有缺陷，遷移到外接資料庫即可。詳情請參見：配置外接資料庫
