常見問題及解決方案

我們在平時的報表運行過程中會遇見各種各樣的問題，下面列舉了一些常見的問題、報錯信息、原因和基本解決方法！

注：JAR 爲 2018.4.9 及之後，不再支持 applet 打印，請使用其他打印方法。

2.1 代碼及含義

注1：10.0設計器和部署包使用的都是 openjdk，而使用 openjdk 無法啓動 flash 打印，但使用 Oracle/sun jdk 可以。

注2：flash 打印目前是已經被淘汰了的技術，很多浏覽器都将不再支持 flash 打印，建議客戶使用零客戶端或本地打印。

2.2 列舉部分解決方案

2.2.1 錯誤代碼：1301

• 報錯：數據集配置錯誤 Query:Cannot create PoolableConnectionFactory ([Microsoft][ODBC 驅動程序管理器] 未發現數據源名稱并且未指定默認驅動程序)

• 原因：驅動的關系，在 64 位系統，64 位的 Tomcat 下，不論是 32 位的 JDK 或者是 64 位的 JDK，都不支持 ODBC 數據源，所以訪問有 Access 數據庫的模板時會報錯。

一般是 JDK 是 64 位的，而且服務上沒有 64 位的 ODBC 數據庫驅動導緻的。

• 解決方案：

1. 方法一：安裝下面兩個驅動，任意一個就行。AccessDatabaseEngine_2007_X64.exe或AccessDatabaseEngine2010_X64.exe

2. 方法二：改用 32 位的 JDK。

2.2.2 錯誤代碼：1303

• 報錯：Death cycle exists at calculating XX 

• 原因: 單元格或者控件計算中, 存在死循環.

• 解決方案：分析檢查下報錯信息中相關的單元格，看其左、上父格的設置是否存在矛盾的地方。

2.2.3 錯誤代碼：1305

• 報錯：模板文件解析出錯file：xxx.cpt

• 原因：直接用 Editplus 等軟件, 查看cpt裏xml内容，檢查模板是否已損壞; 如果是 FREncrypt 開頭的, 那可能模板是加密的;

如果裏面是空白的, 那麽就是模板損壞了, 可能是保存的過程中服務器挂了或者被重啓了, 客戶端遠程網絡中斷了等等

2.2.4 錯誤代碼：1101、1102、1103、1104、1107、1108

如果用戶所在場景行式引擎無法支持，則可以試用 新計算引擎插件 ，該插件實現了多數據源情況下的分頁查詢功能，用戶無需再寫複雜的分頁 SQL 或 JS 按鈕，就可以讓報表快速完成首頁加載。
注：該插件支持 Oracle、SQL Server、MySQL、HANA、PostgreSQL、Impala、DB2 等大部分主流 JDBC 數據源。

3.1 address pool is full 

• 原因：地址池滿，連接數超過并發數上限

• 解決方案：在管理系統>智能運維->系統情況下面，看到當前系統在線用戶數，然後再比較注冊信息頁面裏的 Concurrency，

判斷是否超過購買的并發數，從而選擇減少并發人數或者增大最大并發數

詳細可查詢 address pool is full 錯誤處理

3.2 java heap space、stack overflow

• 原因：模板太複雜，數據量大， 堆棧溢出

• 解決方案：優化數據集，報表采用分頁預覽方式；調大服務器内存。

處理方法可參考 Java heap space 報錯、報表性能優化。

3.3 下拉複選框返回值問題

• 原因：下拉複選框控件返回值默認情況下是數組，參數取到的字符串是不帶引号的（所以在數據集定義的 SQL 語句中調用字符串類型的參數的話要手動加上單引号才行）。多個值用 in，SQL 的 in 語句參數是字符串數組，每個都要求帶單引号。

• 解決方案：轉化下，把控件的返回值改成字符串，間隔符用','。

3.4 本地預覽的效果和服務器上的效果不一樣

• 原因：JAR 包存在差異或者緩存問題

• 解決方案：更新 JAR 包，确保開發環境和服務器平台一緻正确，仍不行可重啓設計器或者清空浏覽器緩存。

3.5 圖表中中文亂碼，出現方框等

• 原因：方框是缺少中文字體的緣故。

• 解決方案：對應計算機系統，下載更新對應的中文字體庫。

3.6 repeated column width is larger...

• 原因：重複列寬度大於紙寬度。

• 解決方案：設置小於列寬就行了。

3.7 由一個單元格擴展出來的行高不一緻

• 原因：某一行内容比較多一行顯示不了，就換行了，所以變寬了。

• 解決方案：将單元格拉寬點就好了。

3.8 自定義數據字典顯示等号問題

• 原因：自定義數據字典，跟單元格還有自定義提示框一樣，如果不是‘=’号開頭是當做字符串處理，‘=’号開頭當做公式處理

• 解決方案：單寫一個等号就是空白的，想要顯示等号的話用="="

3.9 找不到數據連接

• 原因：數據連接或者數據集配置問題

• 解決方案：查看配置是否有問題，詳情參考：預覽模板數據集配置錯誤

3.10 an internal error occurred

• 原因：安裝 exe 時會出現的報錯，一般是因爲下載下來的安裝文件有損壞, 不完整.

• 解決方案：在官網用浏覽器下載的 官方 exe.

3.11 index xx,size xx

• 原因：一行的高度大於一頁的高度。

• 解決方案：可以縱向合并單元格，使一格占多行，這樣就可以把行高大於頁高的單元格拆分爲多行進行計算了，預覽就會以多頁的方式顯示出來。

                        列寬同理，一個單元格的長度不能大於一頁的寬度。否則将會出現錯誤，可以橫向合并單元格。

3.12 TTf is not a valid TTF or OTF file

• 原因: pdf 導出會掃描本地的字體文件, 如果字體損壞, 就會有上述報錯. 

• 解決方案: 提示哪個字體損壞, 就拷貝一份過去.

3.13 UnsupportedClassVersionError

• 原因: 一般是由於技術支持給客戶定制修改過 JAR 包裏的 class 導緻的

• 解決方案：需要将 IDE 的工程編譯等級調整到 1.6.

3.14 java.lang.AbstractMethodError

• 原因: 一般都是因爲引擎的 JAR, 插件的 JAR, 以及設計器的 JAR, 這三者之間不同步, 不是同一個時間編譯出來的.

• 解決方案: 更新所有 JAR.

3.15 java.lang.NoClassDefFoundError 

3.15.1 具體報錯：sun.awt.X11GraphicsEnvironment  Could not initialize class sun.awt.X11.XToolkit

原因:  一般發生在 Linux 下, 處理圖片時需要本地的 jvm x-server 的支持.

解決方案：啓動 Java 時加上參數:-Djava.awt.headless=true 例如:我們在啓動 Tomcat 時在啓動命令行裏面加上這個參數就可以了.

對於 WebLogic 可以設置在/export/home/xxx（用戶名）/weblogic/wlserver_10.3/common/bin/commEvn.sh中

Sun)
    JAVA_VM=-client
    MEM_ARGS="-Xms1024m -Xmx1024m -XX:MaxPermSize=1024m"
    JAVA_OPTIONS="${JAVA_OPTIONS} -Xverify:none"
  ;;
  *)
    JAVA_VM=
    MEM_ARGS="-Xms1024m -Xmx1024m"
  ;;
  esac
fi
export JAVA_VM MEM_ARGS JAVA_OPTIONS

之後添加下面兩句：

JAVA_OPTIONS="${JAVA_OPTIONS} -Djava.awt.headless=true "
export JAVA_OPTIONS

對於 WebSphere 則進入應用程序服務器 > server1 > 進程定義 > Java 虛拟機

一般 JVM 自變量 ：-Dfile.encoding=GBK -Ddefault.client.encoding=GBK -Djava.awt.headless=true

3.15.2 具體報錯：com/fr/general/logRecordTime

JAR 包一緻的前提下, 删掉所有的插件, 先确定 Tomcat 下獨立部署有沒有問題, 

如果沒問題, 再看看是不是要改 WebLogic的 JRE.

3.15.3 具體報錯：com/fr/web/core/service/WidgetService

• 原因：放錯了 Applet 包導緻的, 比如把 Applet 放到裏 lib 目錄等等.

• 解決方案：将 Applet 放到%FR_HOME%\webapps\webroot目錄下

3.15.4 具體報錯：sun/io/UnknownCharacterException

• 原因：這個類是 jdk1.7 導緻的

• 解決方案：用 1.7 的 JDK 可以解決報錯.

3.16 final block not properly padded

• 原因: DES 加密的類初始化有問題, 不過只在 OpenJDK 裏遇到過.

• 解決方案：換成正常 Linux 下的 JDK 就好了.

3.17 javax.mail.SendFailedException

• 報錯：Invalid Addresses  javax.mail.AuthenticationFailedException

• 原因：郵件收件人, 郵箱賬号密碼錯誤或者郵箱服務器有問題,被郵箱服務器拒絕了連接, 可能判定爲發送垃圾郵件等行爲

• 解決方案：重新輸入收件人及密碼等或者換個郵箱.

3.18 java.lang.SecurityException

• 具體報錯信息：class "xx"'s signer information does not match signer information of other classes

• 原因：class 被重複加載了, 最常見的就是 webapps/webroot/WEB-INF/lib 裏多放了一個 Applet 包.

• 解決方案：删除即可

3.19 java.lang.NoSuchMethodError

• 原因：一般都是 JAR 包不匹配

• 解決方案：設計器 lib, webapps 裏的 lib 以及插件三者要保持一緻.

3.20 Invalid argument 

• 具體報錯信息：Invalid argument to native writeImage

• 原因：一般是因爲 JDK 不支持部分圖片的解碼

• 解決方案：将模板裏圖片重新用 qq 截圖之類的生成 png 之類試試.

3.21 TDS protocol stream is not valid

• 具體報錯信息：connection to SQL Server by using Secure Sockets Layer (SSL) encryption. Error:The TDS protocol stream is not valid

• 原因：jtds 連接 SQL Server時，SQL Server 啓用了安全認證

• 解決方案：把客戶端加到認證列表裏.

3.22 ParseError at [row,col]:[x,xx]

• 具體報錯信息：com.fr.third.javax.xml.stream.XMLStreamException : ParseError at [row,col]:[x,xx]

• 原因：xml 文件内容有損壞, 具體哪一行那一列, 看[row, col]提示.

• 解決方案：看報錯裏是哪個 manager 導緻的, 一般

DatasourceManager -> datasource.xml

FunctionManager -> functions.xml

ConfigManager -> config.xml

CustomConfigManager -> customconfig.xml

WidgetManager -> widgets.xml

3.23 Not found resource

• 具體報錯信息：com/fr/web/core/hack/PIE.htc

                       或者 Not found resource: /com/fr/fs/resources/fonts/iconfont.eot?

• 原因：這兩個都是ie低版本下不支持某些樣式或者 css 的寫法導緻的, 并不影響使用.可能會損失寫透明陰影之類的特效.

• 解決方案：使用高版本的IE

3.24 java.net.SocketException

3.24.1 具體報錯信息：Connection reset by peer 或者 Broken pipe

資源文件讀取失敗, 原因有很多, 需要更細緻的排查

• 可能原因:

      ①服務器的并發連接數超過了其承載量，服務器會将其中一些連接 Down 掉；

      ②客戶關掉了浏覽器，而服務器還在給客戶端發送數據；

      ③浏覽器端按了 Stop

• 解決方案：

      ①減少并發，如果知道實際連接服務器的并發客戶數沒有超過服務器的承載量，則有可能是中了病毒或者木馬，引起網絡流量異常。

      ②、③這兩種情況一般不會影響服務器。

但是如果對異常信息沒有特别處理，有可能在服務器的日志文件中，重複出現該異常，造成服務器日志文件過大，影響服務器的運行。

可以對引起異常的部分，使用 try...catch 捕獲該異常，然後不輸出或者只輸出一句提示信息，避免使用 e.printStackTrace(); 輸出全部異常信息。

3.24.2 具體報錯信息：ClientAbortException:java.net.SocketException

• 原因：處理 http 連接時，正在輸出内容時，用戶關閉了 IE，會出現一個"ClientAbortException"，屬於 I/O 處理中出現的一個異常

注：不一定是用戶主動觸發的, 網絡不穩定時也有可能出現.

3.25 OPTION SQL_SELECT_LIMIT=DEFAULT

• 具體報錯信息：You have an error in your SQL syntax；check the manual that corresponds to your MySQL server version for the right syntax to use near 'OPTION SQL_SELECT_LIMIT=DEFAULT' at line 1 
  

• 原因：JDBC 在連接數據庫時候會發送測試語句 SET OPTION SQL_SELECT_LIMIT=DEFAULT 
  這在MySQL5.6 以下版本是可以的 ，但是 5.6 不再支持 SET.

• 解決方案：升級驅動到對應數據庫版本即可

3.26 Error Happens On Picture Analysis

• 原因：Excel 導入的時候部分圖片可能會解析失敗, 或者獲取的寬高有問題.

注：如果頁面上需要的内容沒問題, 那麽可以無視這個報錯

3.27 Can't create cache file

• 原因：Tomcat 下沒有 temp 目錄, 或者是 temp 目錄寫入權限不夠

• 解決方案：在 Tomcat 的安裝目錄下創建這個目錄就好了

3.28 Excel format pattern not supported

• 具體報錯信息：Excel format pattern not supported by java

• 原因：一般是因爲Excel裏用了什麽自定義的數字樣式, 導入報表中的時候用 Java 解析發現不支持

3.29 Cannot load JDBC driver class

• 原因：驅動問題

• 解決方案：查看數據庫驅動是否正常. 如果确定驅動是有的, 再看 JDK 與驅動是否匹配

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

• 原因：可能是 jdk1.8的bug。

• 解決方案：安裝内置 jdk1.7 的設計器 windows_FineReport-CN_jdk1_7.exe

3.31 paged queries not supported

• 原因：當前數據庫不支持分頁查詢行式引擎

• 解決方案：換個數據庫比如 MySQL, SQLServer, Oracle 等等。

3.32 Cannot connect to site server: xxx

• 原因：連不上應用商店, 不影響使用。

3.33 no function found: XXX

• 原因：沒找到自定義函數, 一般都是設計器本地的cpt拷到服務器上, 自定義函數沒拷過去.

3.34 Cannot get a connection

• 具體報錯信息：Cannot get a connection,pool error Timeout waiting for idle object

• 原因：數據庫連不上, 連接池滿了或者超時之類的. 

• 解決方案：點擊服務器>定義數據連接，如下圖所示，點擊連接池屬性，彈出連接池屬性編輯框，調整最大活動連接數

3.35 com.fr.stable.fun.Level

• 具體報錯信息：com.fr.plugin.record.FunctionRecordManager cannot be cast to com.fr.stable.fun.Level
  

• 解決方案：删除 plugins 目錄下的老的功能點記錄插件. 停止維護了。

3.36 Class not found: JForm

• 原因：打開報表的時候出錯了, 可能是因爲用了某個插件而當前設計器沒裝該插件等等. 具體要看更詳細的日志

3.37 泰語 韓語等小語種亂碼

• 解決方案：修改 fs 裏的編碼設置爲 UTF-8

3.38 Get PublicKey method failed

• 具體報錯信息：Get PublicKey method failed，status is : -1
  

• 解決方案：連不上數字簽名服務器了, 檢查網絡是否可以ping通以及數字簽名所在服務器是否正常, 看不出來問題就重啓下.

3.39 java.lang.OutOfMemoryError

• 原因：内存溢出了

• 解決方案：重啓後觀察. 如果頻繁内存溢出建議安裝防宕機插件

3.40 預覽 Multiple exceptions, web 端卡住

• 原因：一般是因爲設計器默認8075端口被占用了

• 解決方案：點擊文件>選項>高級，換一個設計器端口, 重啓.

3.41 Could not initialize class

• 具體報錯信息：Could not initialize class Sense4.Sense64
  

• 原因：fs 裏開啓了加密狗注冊, 但是沒有安裝對應的驅動.

3.42 Web 端出現 404 報錯

• 具體報錯信息：web端出現404 - /webapps/webroot/[object%20Object]

• 解決方案：update: 2016-11-17之後的jar已修複該bug.

3.43 com.fr.test.xxx not found

• 具體報錯信息：啓動 Tomcat 有一些 function: com.fr.test.xxx not found!

• 原因：性能組那邊爲了提升自定義函數計算速度, 将自定義函數放在啓動的時候去加載;

如果自定義函數找不到就會有這個報錯, 一般不影響, 因爲有一些是我們内置的 demo.

3.44 UNEXPECTED WIDGET 

• 報錯：設計器打開模板, 找不到控件

• 原因：一般是用了自定義控件, 或者某個插件裏的控件, 當前運行環境裏找不到.

3.45 設計器直接起不來

• 解決方案：先用任務管理器查看進程, 是不是有 designer.exe, 有就關掉再啓動試試.

• 如果還是不行, 打開 bin 目錄的 designer.bat, 在最後一行添加 pause, 保存後啓動 designer.bat, 查看報錯.

3.46 design_open error

• 原因：遠程設計, 模板打開報錯, 打開一些簡單的模板試試, 如果簡單的可以, 只有部分不行, 考慮是不是兩邊jar不一緻, 插件不一緻.

3.47 插件列表讀取失敗

• 原因：一般是因爲網絡原因導緻連接不到商城

• 解決方案：直接浏覽器裏訪問商城看看能不能訪問到. https://market.fanruan.com/

3.48 設計器界面錯亂, 菜單顯示成英文

• 原因：可能是上一次打開的模板裏面用了當前環境裏不存在的插件元素

• 解決方案：Ctrl + N 新建一張模板後, 退出設計器.再次啓動.

3.49 程序數據集界面上設置了參數無法保存

• 原因：程序數據集 class 裏自己定義了參數,  會跟界面沖突, 出於兼容原因, 優先選擇使用 class 裏設置的.

• 解決方案：删掉程序數據集 class 裏的參數, 直接用界面上的. 代碼中不去 setParameter, 直接 getParameter 即可.

3.50 打印或者導出，内容在頁尾截斷了

• 原因：Web 端預覽的時候, 浏覽器可以自動撐開 div, 而打印導出的時候,  是嚴格收到頁面大小限制的, 所以會截斷.

• 解決方案：把截斷的單元格設置成分頁可以斷開.

3.51 com.fr.base.TableData$1 

• 具體報錯信息：com.fr.base.TableData$1 cannot be cast to com.fr.data.impl.NameTableData

• 解決方案：看堆棧, 上圖堆棧就是某個單元格用了公式形态, 但是公式沒獲取到對應的數據集. 具體哪個單元格, 可以通過二分法确定.

3.52 java.io.FileNotFoundException

• 具體報錯信息：java.io.FileNotFoundException: xxx.cpt or xml (拒絕訪問)

• 原因：文件不存在, 或者web浏覽器沒有文件夾的訪問權限。

3.53 遠程設計連接服務器總是斷開連接

先排查下兩邊 JAR 是否一緻, 如果一緻, 看看有沒有條件在服務器上裝一個設計器, 直接 localhost 看看會不會失敗.

如果 localhost 是好的, 通過 IP 不行, 可能是網絡問題. 在連接失敗的時候, ping 服務器 IP 看看網絡響應延遲.

3.54 WcardTitleLayout cannot be cast

• 具體報錯信息：WcardTitleLayout cannot be cast to com.fr.form.ui.ElementCaseEditorProvider

• 原因：更新了 JAR, 沒更新自适應插件.

3.55 Web 端訪問 cpt, 提示找不到模板

• 原因：是不是所有的 cpt 都找不到, 還是說只有部分新增的找不到? 如果是新增的找不到, 是不是集群沒有同步到其他節點.

所有的 cpt 都找不到, 去 fs > 智能運維->系統情況 > 系統狀态 > 配置文件檢測 查看 xml 文件都放在哪的. 從該路徑查找 reportlets 目錄.

3.56 Applet 打印沒反應

• 原因及解決方案：确認下客戶浏覽器信息, 目前 Chrome 下不支持 applet 打印, 只支持 flash, pdf 以及本地打印.

IE 下建議安裝  32 位 JRE, 并且在控制面板 - Java設置 - 安全, 把http://localhost:8075加入進去.

3.57 Canot run program xx

• 具體報錯信息：Canot run program xx, error=12, Cannot allocate memory

• 解決方案：修改下 JVM 的内存配置, 初始内存調小點，詳細方法可參考 FR 性能測試注意事項

3.58 7.0 設計器打不開 8.0 的模板

• 解決方案：用 EditPlus 之類的軟件打開 XXX.cpt, 找到倒數第二行 <DesignerVersion DesignerVersion="IAA"/>，将其删除.

注：如果模板裏用了新版本的一些屬性, 那麽在老的設計器裏強行打開會報錯.

3.59 Web 端訪問模板, 出現 "頁面排隊中"

原因：應該是内存快滿了, 防宕機插件啓動 Session 排隊功能了.

3.60 Flash 打印截斷

• 原因：一般是因爲頁面用了非 A4 的紙張, Flash 打印無法傳遞頁面設置到打印機.

• 解決方案：這種一般建議使用 PDF 打印或者本地打印.

3.61 war 包部署, 修改 xml 再次部署後未生效

• 原因：WebLogic 下, war 包部署是不解壓的, 所以我們會把所有的 xml 拷貝到臨時目錄進行增删改.

• 解決方案：可以通過訪問 op=fr_base&cmd=evaluate_formula&expression=jvm() 查看緩存路徑, 删掉緩存路徑的 FineReport8.0 文件夾再部署.

3.62 java.net.BindException

• 具體報錯信息：java.net.BindException:Address already in use: JVM_Bind

• 原因：一般都是上一次 Tomcat 沒有徹底關掉就再次啓動導緻端口被占用了.

3.63 當前hsql已被另一線程鎖定

• 原因：兩個 Web 服務器共用了同一個 WebReport. 最常見的, 啓動了 Tomcat, 設計器也用本地目錄切了過去.

或者 Tomcat 裏用了 docBase 映射, 映射的地址是tomca/webapps中的 WebReport, 這樣會被加載兩次.

• 解決方案：删掉 db.lck,重啓 Tomcat 服務可以解決

3.64 Web 端 654 和 655錯誤

• 原因：加載了有問題的 class 文件做出的程序數據集

• 解決方案：程序數據集 class 必須放在%FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data下，編譯好了後的 class 名也不能修改。

3.65 Can't create cache file錯誤

• 原因：Tomcat 下沒有 temp 目錄, 或者是 temp 目錄寫入權限不夠

• 解決方案：Linux 下創建 temp 目錄，賦權限 777；Windows 下可以把工程從 C 盤移到 D 盤。