FDL啟動問題排查

  • 文檔創建者:fanruan12321
  • 編輯次數:20
  • 最近更新:Nikozhan 于 2026-01-19
  • 1.1 平台介面報錯:資料平台啟動未成功,請稍等

    原因1

    查看fanruan.log日誌,報錯未知的名稱或服務

    伺服器的主機地址沒有綁定ip地址

    解決方案:

    Linux伺服器下輸入hostname,查看主機名。

    在etc/hosts的127.0.0.1的後面加上查到的hostname。

    參考:https://blog.csdn.net/M983373615/article/details/103195151

    原因2

    日誌無相關報錯,但是缺少jar包:fine-bi-engine-third-5.1.jar,報錯:

    解決方案:

    一般是FineReport整合部署FDL時出現。

    可以聯絡帆軟技術支援獲取對應版本的jar包;

    原因3

    FR版本和FDL版本不匹配,報錯Data Platform start failed,fine-data-prep-11.0.jar:?

    fine-data-prep-11.0.jar還是插件版本的FDL,屬於很久之前的版本,而FR已經是最新的版本,兩者之間不匹配,查看catalina.out日誌報錯如下:

    解決方案:

    升級FDL版本,參考說明文檔即可,插件版FDL需要先刪除舊jar包[fine-data-prep-11.0.jar],再put 命令新jar包,注意備份。

    原因4:

    BI6.0整合的資料平台,Spider引擎啟動失敗,導致FDL啟動失敗。BI啟動失敗是因為netty-all-4.1.17.Final.jar衝突,該jar包內容已做到主線jar裏,可以刪除。fanruan.log日誌報錯如圖。

    解決方案:

    移除netty-all-4.1.17.Final.jar。

    1.2 啟動報錯:檢查到1項配置異常,資料庫連結異常

    原因:

    一般是整合版本FDL會出現該問題,主要是FR的內建庫不能多執行緒連結,有其他應用正在使用內建庫,導致報錯。

    解決方案:

    切換為外置庫,或者刪除db.lck。FR安裝目錄\webapps\webroot\WEB-INF\embed\finedb 下的 db.lck 檔案刪除。

    注:該方法在運作一次後仍會報錯,需要反覆刪除 db.lck 檔案。

    1.3 Linux環境FDL啟動報錯

    Could not initialize class sun.awt.X1Graphics Environment

    原因:

    FDL安裝包預設透過GUI圖形化頁面啟動,但是在linux環境下是沒有圖形化頁面的,所以報錯 ,在啟動時新增 -c命令,使啟動策略調整成透過控制台的方式。

    解決方案:

    報錯文檔:https://stackoverflow.com/questions/21131855/could-not-initialize-class-sun-awt-x11graphicsenvironment-on-solaris,操作方法:./XXX.sh -c

    1.4 使用sh安裝檔案,在linux用./FineDataLink命令無法啟動安裝程式


    產生原因:

    linux環境語言不對

    解決方案:

    linux語言LANG改為zh_CN.UTF-8,改好後重連一下shell再啟動FDL

    1.5 使用sh安裝檔案,報錯Unpacking JRE


    解決方案:

    執行以下yum命令

    yum install -y fontconfig

    yum install -y urw-fonts

    安裝一下字體,檢查安裝路徑下面有沒有檔案殘留,有的話刪掉,再重新部署下就可以

    1.6 安裝啟動進入瀏覽器異常,日誌報錯database is not initilized

    原因:

    tomcat和伺服器記憶體都比較小,資料庫沒有啟動

    解決方案:

    修改tomcat記憶體大小,catalina.bat.參考BI是增加如下語句,具體數值需要自己修改

    set JAVA_OPTS=%JAVA_OPTS% -Xms4g -Xmx8g

    set  JAVA_OPTS=%JAVA_OPTS% -XX:PerBytecodeRecompilationCutoff=-1

    set  JAVA_OPTS=%JAVA_OPTS% -XX:PerMethodRecompilationCutoff=-1

    儲存後重啟即可。

    1.7 安裝FDL報錯環境缺少檔案

    原因:

    Windows環境缺少檔案

    解決方案:

    參考百度,修改環境:https://blog.csdn.net/Tianxuan_kong/article/details/120060738

    1.8 瀏覽器存取工程異常,頁面空白

    原因:

    FR的jar自動升級,版本太高導致和FDL不匹配

    解決方案:

    根據FR版本,升級FDL工程,重啟後可以了

    1.9 Tomcat啟動失敗,Catalina.out中報錯如圖內容

    原因:

    一些執行緒依然在運作,這個時候由於堆疊磁軌除錯的,想試圖終止執行緒,導致非法存取。

    解決方案:

    修改FDL目錄下conf資料夾下的server.xml,在Host標籤把reloadable(或者autoDeploy)的屬性值設為:reloadable=“false”(autoDeploy="false")。可參考以下連結內容。

    https://blog.csdn.net/xiaozhuzhuyang/article/details/113186452

    1.10 FDL和BI同一瀏覽器存取時不能同時登入

    現象描述:

    部署包安裝的FDL

    同一個瀏覽器,存取BI和FDL的平台,登入其中一個平台,另一個平台會被登出需要重新登入;

    同一個瀏覽器,存取同一個伺服器下部署在不同路徑的工程,僅埠號不同,當其中之一登入另一個被踢出。

    原因分析:

    身分資訊存在token中,token存在cookie中,cookie只到域名。

    解決方案:

    • 在FDL工程的fine_conf_entity表中新增欄位ServerConfig.cookiePath,值設定為/webroot1,將tomcat/webapps的工程名也改為webroot1,此時工程A的cookie將存入/webroot1中,工程存取路徑為:http://localhost:8080/webroot1/decision

    • 在BI工程的fine_conf_entity表中新增欄位ServerConfig.cookiePath,值設定為/webroot2,將tomcat/webapps的工程名也改為webroot2,此時工程B的cookie將存入/webroot2中,工程存取路徑為:http://localhost:8081/webroot2/decision

    1.11 FDL提示網頁無法存取,可以查到tomcat的進程

    現象描述:

    fdl無法開啟,重啟tomcat也不行,能查到tomcat進程。

    原因分析:

    重啟伺服器,再重啟tomcat,發現真正報錯. /tmp 無法寫入。

    解決方案:

    透過 du -sh * 命令從根目錄一層一層找下,發現catalina.out達到32G,清理日誌並設定日誌級別Tomcat日誌檔案過大的解決方案 。

    1.12 提示資料平台未啟動

    現象描述:

    FDL 啟動後進入平台,提示資料平台未啟動,之後也一直是未啟動的狀態。 日誌報錯Caused by: java.lang.IllegalStateException: Duplicate key SUCCESS

    解決方案:

    升級到 4.0.26 及之後版本。

    1.13 啟動報錯404

    現象描述:

    啟動工程後,存取工程報錯 404 。

    解決方案:

    磁碟空間滿了。可清除大檔案/磁碟擴容來解決。




    附件列表


    主題: 部署升級
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    獲取幫助
    線上支援
    獲取專業技術支援,快速幫助您解決問題
    工作日9:00-12:00,13:30-17:30在线
    頁面反饋
    針對當前網頁的建議、問題反饋
    售前咨詢
    業務咨詢
    電話:0933-790886或 0989-092892
    郵箱:taiwan@fanruan.com
    頁面反饋
    *問題分類
    不能為空
    問題描述
    0/1000
    不能為空

    反馈已提交

    网络繁忙