影響匯出列印效果的環境因素

匯出列印在使用程式中，會有很多因素影響其最終的效果。透過對這些因素進行說明，來幫助使用者更好的使用匯出列印功能，主要影響的因素包括 JDK、註冊功能、字體、權限、瀏覽器等。

2.1 須知

（1）FineReport 10/11 設計器支援 JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上。

（2）FineReport11 有內建JDK 11 的設計器版本，可直接使用，詳情請參見：內建JDK11的設計器

jdk1.8.0_262，jdk-8u231，jdk1.8.0_192 三個版本不建議使用匯出功能將普通報表匯出為 PDF 或圖片。

openjdk：1.8.0_332-b09 存在匯出pdf亂碼，excel正常的問題

2.2 案例

2.2.1 匯出圖表空白

問題描述：

1）匯出圖表空白，且範本有報錯資訊："C library and JDK version do not meet the requirements, Please upgrade GBLIC to 2.17 And GLIBCXX to 3.4.19 or JDK to 1.8"

2）排程管理時，匯出圖表空白，系統訊息提示運作失敗，日誌中報錯："C library and JDK version do not meet the requirements, Please upgrade GBLIC to 2.17 And GLIBCXX to 3.4.19 or JDK to 1.8"

原因分析：匯出的範本中存在圖表，由於工程缺少j2v8相關的環境，用nashorn效能比較慢。需要升級GCC

解決方案：升級GCC編譯環境，詳情請參見：圖表匯出升級說明

2.2.2 圖片預覽正常，匯出底色變紅

問題描述：圖片預覽正常，匯出底色變紅，大部分圖片匯出都異常

原因分析：jdk裏imageio.read特定圖片的bug

解決方案：用自訂函式和png格式圖片規避

2.2.3 匯出PDF未換行或者文字重疊

問題描述：匯出PDF後，原本需要換行的地方沒有換行，內容上限溢位到右邊。字沒有分開，擠在一起

原因分析：JDK bug

解決方案：更換JDK

3.1 字體使用邏輯

預覽、匯出、列印報表時，報表最終呈現的字體效果和設計器、伺服器、瀏覽器所在的本地系統緊密相關。

預覽、匯出、列印報表時，字體主要來源於以下三個字體庫：

• 系統字體：設計器、伺服器、瀏覽器所在裝置的系統字體。Windows系統所在位置：C:/Windows/Fonts；Linux系統所在位置：/usr/share/fonts

• 伺服器依賴的 JRE 下的字體：%Tomcat%/jre/lib/fonts

• 安裝「itext7匯出及國際化換行插件」後對應的字體檔案：%FR_HOME%/webroot/WEB-INF/fonts

不同場景，使用的字體庫不同。如下表所示：

詳情請參見：字型缺失檢測

3.2 字體缺失時的現象

1）匯出圖表時，圖例、分類名包含中文+英文的字串時，比如“一二三abc”，匯出會發生上下錯位；文字空白，只有圖表

2）pdf 匯出時，文字擠壓重疊/模糊/亂碼/變成另外一種字體

3）列印結果有偏移/針式列印斷斷續續/條碼列印時錯開

4）前台明確提示：不支援這個字體

3.3 字體不支援時的現象

1）上標顯示異常，因為宋體沒有上下標設定，大部分字體也只支援數字1,2,3

2）帶√ 的框型字元無法正常匯出，因為特殊符號並不是所有字體都能轉列，excel可以自動選擇可以轉列的字體，PDF不會自動選擇

3）本地設計器匯出的pdf裏面的字體不一樣，因為字體本身權限有問題，字體嵌入性受限

4.1 邏輯說明

excel匯出需要用到臨時資料夾，而匯出PDF不需要

4.2 排查思路

1）windows：檢查Tomcat根目錄下是否有temp資料夾。

• 如果有，備份後清空 temp 資料夾下的內容或者更改臨時檔案目錄（參考 Tomcat中指定日誌/臨時檔案路徑），重啟tomcat。

• 如果無，在 tomcat 根目錄下建立 temp 資料夾，重啟 Tomcat。

2）Linux：

• 缺少臨時目錄檔案： 使用jinfo <pid> | grep "java.io.tmpdir"查看臨時目錄路徑，檢查這個目錄下面有沒有 poifiles 資料夾，當這個資料夾缺失的時候，會導致Excel匯出0KB， 需要重啟 web 伺服器，會重新自動生成poifiles資料夾。

• 權限問題：非 root 使用者啟動 tomcat 可能無法建立臨時目錄和檔案 /tmp/poifiles，需要修改檔案或目錄所屬的使用者或使用者組。

3）快取路徑修改：FineDB 資料庫的 FINE_CONF_ENTITY 表中，修改CacheConfig.cacheDirectory 

4.3 案例

4.3.1 資料夾權限/不存在

1）temp檔案滿了或無temp資料夾，匯出execl提示：java.io.expection：no such file or directory，匯出的 excel 是 0kb

2）匯出報錯：/root/.FineReport100/cache/webroot/excel-temp/TEMP_ XXXXXXX（Perminssion denied）

3）範本分頁匯出或者分頁分 sheet 匯出都報錯， 原樣匯出能成功 但是檔案是 0kb

4）匯出PDF/WORD等格式正常，匯出EXCEL沒有內容

4.3.2 資料夾空間

報錯：because there was insufficient free space available after evicting expired cache entries - consider increasing the maximum size of the cache

5.1 邏輯說明

出於安全性的考量，平台在「安全防護」介面內提供了一些安全功能開關，包括：Cookie 增強、HSTS 設定、檔案上傳校驗、腳本呼叫公式限制、Security Headers、請求回应優化、Token認證增強。需要關注以下兩個設定：

【點選劫持攻擊防護】：開啟後，預設頁面只能在同一個域中載入

【內容嗅探攻擊防護】：開啟後，禁用瀏覽器類型猜測來保證安全性

詳情請參見：安全防護

5.2 案例

5.2.1 跨域呼叫失敗

問題描述：

• 自訂列印按鈕js，調的列印API，直接預覽列印正常，嵌入頁面後列印，f12報錯跨域

• 平台呼叫URL匯出未生成匯出檔案，直接在範本預覽介面url加&format=excel匯出正常，F12有報錯500

• https環境下安裝FR印表機軟體，並且修改了配置檔案 'httpsMode' : true ，但是啟動仍報錯失敗
  

原因分析：跨域使用

解決方案：決策平台安全關閉關閉【點選劫持攻擊防護】和【內容嗅探攻擊防護】

補充說明：谷歌瀏覽器HTTPS_SameSite_跨域，詳情請參見：谷歌瀏覽器單點登入失敗

5.2.2 印表機啟動失敗

問題描述：列印前端控制台報錯：This request has been blocked; the content must be served over HTTPS

原因分析：本地列印沒有配https

解決方案：修改了配置檔案 'httpsMode' : true，詳情請參見：本機列印https配置說明

6.1 邏輯說明

1）不支援特定瀏覽器與低版本

• MAC瀏覽器safari會出現匯出亂碼的問題

• ie8版本、低版本谷歌瀏覽器

2）特殊設定：

• 瀏覽器設定》管理載入項》工具欄和擴展 Adobe Reader開啟

• 谷歌瀏覽器啟動了新的安全策略，不再允許非 HTTPS（F12前端有明顯報錯）

• 特定軟體下載PDF或excel，如迅雷下載插件，會導致匯出0KB
  

6.2 案例

1）mac12.1 本地設計器匯出excel，裏面的資料沒亂碼，但是檔案名稱亂碼

2）360瀏覽器，極速模式異常，相容模式正常

3）本地的列印方法無法列印，但是零用戶端是可以的，原因是遠端伺服器呼叫本地列印軟體，跨域限制

4）瀏覽器最小字體設定導致的預覽與匯出效果不一致，以edge浏览器為例，按照"設定→外觀→字型"的步驟，最小字體設定如下調整

7.1 版本因素

7.1.1 因擴展名無效無法開啟檔案

原因分析：未安裝對應版本的 excel 軟體,低版本 excel 無法開啟高版本檔案

解決方案：安裝「匯出excel方式選擇」插件，然後範本 web 屬性選擇匯出成 excel2003 的。

7.1.2 試圖開啟檔案錯誤

原因分析：受保護的檢視表/來自其他電腦，檔案被鎖定

解決方案：透過修改受保護的檢視表/來自其他電腦，勾選解除鎖定。

7.2  常見問題

7.2.1 報錯詳情：Report index :1, Layer Report can not export by this way

原因分析：10.0 行式引擎插件+流式匯出 excel 插件,不支援分頁分 sheet 匯出 excel。

解決方案：關閉插件後匯出。