反饋已提交

網絡繁忙

設計器啟動常見問題

1. 概述

使用者在使用中會遇到設計器啟動失敗的場景,但是不知道如何定位問題或者解決問題,本文根據常見的啟動類客戶 bug 原因及解決方案,整理出了標準的排查步驟流程圖,使用者也可根據具體出現的情況查詢解決方案:

2. 設計器閃退

設計器產生閃退的常見原因如下:

1)產品內的原因:

  • 記憶體不夠

  • finedb有問題

  • 比如javafx實現的插件管理在windows下頻繁使用會造成閃退(查明是javafx bug 升級jdk 或直接升級最新版 即可解決)

2)系統原因:

  • 系統權限問題

3)其他軟體衝突:

  • 輸入法dll導致

  • 其他系統或者三方軟體的dll

  • 殺毒軟體

設計器閃退常見的排查思路如下圖所示:

2.1 設計器啟動,載入至頁面後閃退,開啟 logs 資料夾下的 fanruan.log 日誌檔案有報錯

問題描述:設計器啟動,載入至頁面後閃退,開啟 logs 資料夾下的 fanruan.log 日誌檔案,報錯如下:2019-03-12T15:06:50.153+0800 WARN Could not find matching type descriptor for requested Java class [java.util.List]; using fallback
2019-03-12T15:06:50.159+0800 WARN Could not find matching type descriptor for requested Java class [com.fr.swift.source.alloter.AllotRule]; using fallback

原因分析:配置檔案中的全局樣式有問題

解決方法:檢查設計器的配置目錄,將 finedb 更換成為一個可以正常啟動的工程中的 finedb

2.2 設計器啟動,載入至頁面後閃退,沒有報錯日誌

原因分析:電腦系統存在問題

解決方法:重新安裝電腦系統

2.3 設計器啟動閃退,error.log中只列印了閃退,沒有列印其他報錯資訊

原因分析:設計器安裝程式中存在異常

解決方法:重裝設計器,並對安裝設計器的伺服器的 jar 包進行升級,即可應用正常

2.4 設計器啟動一直閃退,查看日誌發現引用了非安裝磁碟下的工程

原因分析:可能是工作區間的問題

解決方法:找到 C 盤 xml 檔案 儲存激活碼後刪除 xml 檔案,重啟設計器

2.5 設計器閃退, 修改記憶體到 4G 也出現閃退

原因分析:設計器安裝錯誤

解決方法:確認電腦系統和安裝設計器系統是否匹配,重新安裝

3. 設計器無法啟動

3.1 設計器全新安裝,無法啟動,開啟 fanruan.log 日誌檔案存在報錯

問題描述:設計器全新安裝,無法啟動,開啟 fanruan.log 日誌檔案,報錯如下:

17:54:56 Thread-16 ERROR [standard] C:\FineReport_10.0\webapps\webroot\WEB-INF\assist\phantomjs\lib\vancharts-all.js (拒絕存取。)

java.io.FileNotFoundException: C:\FineReport_10.0\webapps\webroot\WEB-INF\assist\phantomjs\lib\vancharts-all.js (拒絕存取。)

原因分析:非管理者使用者(非 Administrator 使用者)安裝設計器,且設計器安裝到了系統槽(C 盤),設計器啟動時,檔案沒有讀寫權限。

解決方法:

1)設計器安裝到非系統槽(除了 C 盤外別的盤)

2)若安裝到了系統槽,那麼需要給資料夾賦予全部使用者的讀寫權限。

3)用管理者使用者(Administrator 使用者)安裝,管理者使用者(Administrator使用者)啟動

3.2 設計器安裝後無法啟動

原因分析:

1)快取/記憶體問題

2)啟動的時候連結了遠端設計平台,遠端設計平台配置了外接庫,外接庫的 root 帳號密碼失效

3)jar 包放置位置錯誤、缺少多個 jar 包、 jar 包不匹配

解決方法:

1)在「任務管理器」中結束進程 designer.exe 和 OpenJDK Platform binary,刪除 C 盤的系統快取,重啟設計器;或清除快取,用大記憶體啟動,可參考:修改記憶體

2)重新登入外接資料庫,重啟伺服器。

3)查看環境,確認 jar 包放置情況及 jar 包是否缺失,並確認 jar 包是否匹配,進行更換或增補即可。

3.3 設計器 exe 啟動無回应

問題描述:設計器 exe 啟動無回应,任務管理器中無設計器執行緒,bin下生成error.log,但error.log是空的,bat啓動設計器正常。

原因分析:系統中存在加密軟體

解決方法:將設計器新增到加密軟體的白名單中即可。

3.4 設計器無法啟動,bat啟動到一定程度閃退,查看錯誤日誌有報錯

問題描述:設計器無法啟動,bat啟動到一定程度閃退,查看錯誤日誌,關鍵報錯:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

解決方法:

1)排查是否為殺毒軟體的問題。

2)任務管理器裏面搜尋設計器進程,刪除後重啟設計器。

3.5 jar 包更換後,設計器無法啟動

解決方法:重裝設計器。

3.6 開機後首次啟動設計器卡在啟動頁面很長時間,然後報錯-出現意外錯誤,關掉後重啟正常

解決方法:備份工程,重裝設計器。

3.7 設計器開啟的時候停在啟動動畫

解決方法:清除快取後重啟設計器。

3.8 設計器無法啟動,報錯含JDK

問題描述:設計器無法啟動報錯:OpenJDK 64-Bit Server VM warning: ignoring option MaxPermSize=128m; support was removed in 8.0

解決方法:重裝設計器。

3.9 設計器無法開啟,開啟日誌報錯

問題描述:設計器無法啟動,開啟日誌報錯:

please check the database service to ensure that it is available jdbc:hsqldb:file://X:\FineReport_XX\webapps\webroot\WEB-INF/embed/finedb/db:hsqldb.tx=mvcc

原因分析:Finedb 問題

解決方法:刪除db.lck檔案,刪除 C 盤快取檔案,重啟設計器。

3.10 啟動設計器報錯:發現與設計器埠衝突的進程,請結束進程或更改設計器埠

解決方法:

1)netstat -ano |findstr “埠號”   將在佔用設計器埠號的進程篩選出來。

2)找到對應的進程後,透過進程的pid查看對應的進程名。命令:tasklist |findstr "pid" 3)透過進程名稱或PID殺掉該進程  命令:taskkill /f /t /im "進程id或者進程名稱"。如:taskkill /f /t /im "java.exe" 或 taskkill /f /t /im "16516" 

注:windows 系統其實在查到佔用埠對應的 pid 或進程名後就可以透過任務管理器直接殺掉進程。

3.11 11.0 設計器無法啟動,報錯為:Exception in thread' main” java. lang. NoClassDefF oundError: com/fr/base/theme/ThemedTemplate

原因分析:JAR包錯誤

解決方法:重新更換jar包

3.12 設計器開啟報錯

問題描述:設計器開啟報錯:please check the database service to ensure that it is  available jdbc

原因分析:讀取不到 finedb 資料庫或者被多個工程讀取導致衝突

解決方法:

1)清除本地快取,C:\Users\使用者目錄下,刪除整個快取檔案

2)刪除\webapps\webroot\WEB-INF\embed\finedb下的db.lck檔案

3)權限不夠,這種情況開啟\webapps\webroot\WEB-INF\embed\finedb一般會提示沒有管理者權限,可以透過管理者身分開啟設計器

4)本地是否同時安裝了設計器跟部署了伺服器,有時候會同時讀取finedb,導致衝突,解決辦法:刪除快取檔案,這個最直接,或者配置一下.FineReportXXX\FineReportEnv下的快取路徑,不要跟tocmat衝突

5)配置過外接資料庫,但是有遷移回去了,或者不知名原因,出現了db.properties檔案,這時刪除/webapps/webroot/WEB-INF/config下的db.properties檔案就行

3.13 開啟設計器一直停在載入頁面

問題描述:開啟設計器後長時間停留在載入動畫頁面,無法進入設計器主頁面。

原因分析:報錯提示 Java 記憶體上限溢位,只是由於設計器記憶體分配不夠導致的。
解決方案:編輯器開啟%FR_HOME%\bin\designer.vmoptions,將設計器記憶體調大一些,修改設計器記憶體的方法參見文檔:修改記憶體

3.14 finereportEnv.xml 檔案損壞

問題描述:設計器啟動失敗,彈出報錯提示資訊:抱歉!設計器啟動出現預期外的錯誤,問題詳細資訊顯示:-1

解決方案:這是由於系統槽 .FineReport110 資料夾內的 finereportEnv.xml 檔案損壞導致的,刪除該檔案即可,如下圖所示:

3.15 國產化設計器安裝後無法啟動

問題描述:中標麒麟ARM系統,linux核心,安裝Linux版設計器。

./designer  啟動報錯:OpenJDK 64-Bit Server VM warning :ignoring option MaxPermSize=128m;support was removed in 8.0

Failed  to load  /etc/os-release

解決方案:

1)第一個報錯可以不關注,可以正常啟動

2)第二個報錯為環境的問題,可以先確認下linux環境是否存在/etc/os-release這個檔案


4. 設計器重啟

4.1 設計器儲存失敗,甚至直接閃退重啟。

問題描述:設計器儲存失敗,甚至直接閃退重啟。伺服器報錯:Exception caught during execution of add command

原因分析:記憶體滿了

解決方法:清理磁碟

4.2 更新完設計器插件後點選立即重啟,然後設計器就一直在呼叫 restart.exe,完全沒辦法正常啟動。

問題描述:設計器升級更新後沒有點選立即重啟,點了稍後重啟,然後又更換了語言,彈出立即重啟,然後設計器就當機了,一直在無線呼叫 restart.exe,設計器完全沒辦法啟動。

解決方法:一直呼叫 restart 的情況下,刪掉設計器的 webroot 同級目錄下 delete.properties 和 restart.lock 檔案就好了。

注:在刪除檔案之前需要先停掉無限啟動的 restart 進程。

       方法1:重啟電腦。

       方法2:修改掉設計器 bin 目錄下的 restarte.exe 的名稱,然後任務管理器掛掉已經存在的 restart.exe 的進程

5. 設計器啟動後異常

5.1 The JVM could not be started

問題描述:啟動設計器時,彈出錯誤提示框,無法正常啟動,錯誤資訊如下:

The JVM could not be started. The maximum heap size (-XMx) might be too large or anti virus or firewall tool could block the execution

解決方法:開啟%FR_HOME%\bin\designer.vmoptions檔案,將-Xmx的值改小一點,修改後重啟設計器即可。如下圖所示:

5.2 設計器頁面錯亂

問題描述:當使用設計器遠端伺服器進行報表設計的時候,有時候會出現設計器卡死問題。當我們再次登入設計器時候,發現設計器顯示頁面錯亂,有時會有英文產生。

解決方法:當出現這個問題時候,只需要進行Ctrl + N建立一個報表,同時將遠端伺服器的 目錄切換 為本地預設目錄,重新啟動一下設計器即可解決問題。

5.3 FineDB 損壞

問題描述:開啟設計器,報錯:配置資料庫出錯,是否重置?將在 embed 資料夾下生成備份並重置。如下圖所示:

注:FineDB 損壞重置之後,生成的 FineDB 是沒有資料的 ,重置須謹慎。

原因分析:

1)產品裝在 C 盤,因為 C 盤需要使用者的權限比較大,有可能會出現這種問題。

2)非管理開啟設計器,對安裝軟體的資料夾沒有讀寫權限。

解決方案:

1)卸載後安裝在 D 盤。

2)使用管理者帳號開啟設計器,或者提高使用者對資料夾的讀寫權限。

5.4 設計器殘留進程佔用 FineDB

問題描述:設計器啟動時如果彈出報錯提示資訊:上次設計器進程未正常關閉,是否結束進程並重啟,如下圖所示:

解決方案:

1)點選結束進程:結束顯示的進程並重啟設計器。

2)點選取消關閉:取消設計器啟動,並在後台殺掉進程。

5.5 埠被其他進程佔用

問題描述:設計器啟動時如果彈出報錯提示資訊:發現與設計器埠衝突的進程,請結束進程或更改設計器埠,表示設計器的埠被其他進程佔用。如下圖所示:

解決方案:點選更改埠後,彈出更改埠號的提示框,使用者可以在正文框中填寫新的埠號。

注1:設計器內建伺服器埠預設為 8075,點選設計器中的預覽方式查看報表時使用這個埠;51462 為設計器預設埠,用來防止設計器多開。所以更改埠號時應避免填寫這兩個埠,以防填寫重複值再次導致衝突。

注2:埠號範圍在 1024~65535 之間。

5.6 未知啟動問題

問題描述:設計器啟動遇到未知錯誤時,會彈出報錯提示資訊:抱歉!設計器啟動出現預期外的錯誤

解決方案:

1)點選重啟:重新啟動設計器。

2)點選:同時關閉彈窗和設計器。殺掉進程重啟設計器或重新安裝後重啟。

5.7 設計器支離破碎, 顯示不全

原因分析:可能是 jdk1.8 的bug。

解決方案:安裝內建 jdk1.7 的設計器 windows_FineReport-CN_jdk1_7.exe

5.8 設計器頁面會跟着滑鼠跑,出現重影

問題描述:只要開啟設計器,頁面就會跟隨滑鼠出現無數重影,完全無法正常使用,重啟、重裝設計器都不行

解決方案:顯卡驅動問題,關閉java3d即可。在designer.vmoptions 配置參數  -Dsun.java2d.d3d=false

5.9 設計器輸入中文閃退

問題描述:設計器安裝後,英文輸入正常。切換中文輸入法輸入,設計器直接閃退。

原因分析:jvm把位元組碼轉換成機器碼出錯了。這個基本是個jdk bug,可以切換jvm的模式(預設是混合模式)

解決方案:找到設計器安裝路徑,%FR_HOME%bin目錄下的designer.vmoptions檔案。最下面配置-Xint參數,避免將位元組碼轉換成機器碼,強制JVM執行所有的位元組碼。

5.10 設計器出現重影

問題描述:更換電腦後,目前解析度為2560*1600,出現設計器錯位這種情況

解決方案:在designer.vmoptions 配置了一下參數 -Dsun.java2d.d3d=false,重啟即可解決

5.11 設計器開啟白屏

問題描述:任意版本設計器開啟都是白屏,重裝設計器也是如此

解決方案:在designer.vmoptions 配置了一下參數 -Dsun.java2d.d3d=false,重啟即可解決。

5.12 設計器無法登入通行證/自動更新/下載插件

問題描述:

1)網路情況是使用代理伺服器,設計器啟動正常,但在設計器和數據決策系統中無法登入帆軟通行證。

2)網路情況是使用代理伺服器,設計器無法自動更新或下載插件。

原因分析:

11.0.8 之前版本設計器不支援代理伺服器。

解決方案:

可參考:FineReport外網地址


附件列表


主題: 產品安裝與升級
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

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

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

不再提示

10s後關閉

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

反馈已提交

网络繁忙