JAR包、插件版本不匹配常見問題

1.1 版本

1.2 問題描述

JAR 包、插件不匹配主要分為以下幾種：

1）遠端設計時，本地設計器與遠端伺服器工程的 JAR 包版本不一致

2）遠端設計時，本地設計器與遠端伺服器工程所安裝的插件/插件的版本不一致

3）手動安裝的插件版本，與設計器/伺服器的 JAR 包版本不匹配

本文主要講解這些不匹配帶來的問題和解決方案。

使用者透過設計器遠端設計連結伺服器時，設計器和伺服器 JAR 包版本要保持一致，設計器和伺服器安裝的插件和插件版本要一致，否則在設計時，會引發一系列的問題。

2.1 問題描述

設計器遠端設計連結伺服器時，當伺服器和設計器的 JAR 包、插件存在不一致時，設計器右上角「通知中心」提示有新訊息。

滑鼠點選出現彈窗提示「遠端設計環境不一致，部分功能將受影響」，如下圖所示：

2.2 解決方案

點選「同步至本地」按鈕。

1）將存在差異的伺服器JAR包，改寫本地設計器的JAR包。

2）將伺服器已啟動、且本地未安裝的插件，安裝到本地設計器中。

3）將存在差異的、且伺服器已啟動的插件，改寫本地設計器的插件。11.0.20及之後版本，會額外刪除本地插件的其他版本包。

更換完成後，自動重啟設計器，並再次遠端到該伺服器。如下圖所示：

注1：若使用如果部分插件未能實現同步，有兩種可能原因：

• 該插件在插件商城由於某些原因已經下架。

• 該插件是內建插件，無需手動安裝，重啟設計器即可。

注2：若設計器處於內網環境：

• 需要使用者參考 設計器升級指南，手動升級設計器版本。

• 需要手動copy伺服器上%Tomcat_HOME%/webapps/webroot/WEB-INF/plugins下的所有插件包，到設計器的%FR_HOME%/webapps/webroot/WEB-INF/plugins以及%FR_HOME%/plugins下，完成操作重啟設計器

2.3 忽略JAR包不一致可能引發的問題

當版本不一致時，會引發的問題主要表現在以下幾個方面。

• 部分範本掛載在平台上後預覽效果和本地預覽時有差異。

• 圖儲存格素顯示不全，如圖表百分比顯示不全、擴展圖表不顯示等。

• 範本無法預覽，範本預覽報錯，預覽資料集時報錯。

• 切換工作區間失敗。

• 範本內容不全，如範本中資料集無法顯示，部分元件無法顯示。
  

• 資料連結成功，但無法對應庫中的表資料。

• 對範本進行重新命名或另存為時，顯示沒有權限。

以下為一些引發問題的詳細介紹。

2.3.1 資料連結成功但無法預覽

資料連結成功，但是建立資料集時，看不到檢視表和表，顯示資料庫連結失敗，如下圖所示：

查看日誌，發現報錯：connection pool shut down，如下圖所示：

2.3.2 預覽資料集時報錯

預覽資料集時，報錯：java.lang.reflect.UndeclaredThrowableException，如下圖所示：

2.3.3 對範本操作時沒有權限

遠端設計時，對範本進行重新命名或另存為時，顯示沒有權限，如下圖所示：

2.3.4 遠端連結時示警

切換工作區間至遠端伺服器時，跳出警告：遠端設計可以連結，但版本不匹配，如下圖所示：

2.3.5 平台 fetchsize 消失

平台中資料連結進階設定中的「Fetchsize」 設定可能會消失，如下圖所示：

每個插件，在插件管理介面、帆軟市場插件介面、對應的插件介紹文檔中都會註明 JAR 包要求。如下圖所示：

當插件版本和 JAR 包版本不匹配時，會影響插件的使用，嚴重的話會影響整個工程的運作，所以建議使用者在使用插件時，要保證插件版本和 JAR 包版本一致。

使用者在安裝、更新插件時或更新工程後，可能會出現插件版本和 JAR 包版本不匹配的情況，在此種情況下，若無提醒或限制，工程就會有一個隱藏的風險。2021-01-25 及以後的 JAR 包，在插件版本和工程 JAR 包版本不匹配時會自動禁用插件並進行提醒。如下圖所示：

在插件管理中安裝、更新、升級、啟動插件或更新工程後啟動工程時，系統會自動檢查插件版本和JAR包是否匹配。當不匹配時會出現彈窗提示。

檢查點為大版本之間是否匹配，即 10.0 、11.0 是否跨版本；當前工程 JAR 包版本是否適應插件說明中要求的最低 JAR 包版本。

3.1 操作插件時

問題描述：

設計器線上或本地安裝、更新、啟動插件時，插件版本匹配，可正常操作，顯示操作成功的提醒。若是因為插件版本不一致導致的安裝失敗，則會彈窗提示版本不匹配。如下圖所示：

• 插件版本高於 JAR 包要求的版本時，提示：***插件版本過高，請升級 JAR 包或安裝低版本插件。

• 插件版本低於 JAR 包要求的版本時，提示：***插件版本過低，請安裝高版本插件。

解決方案：出現此情況後，使用者需檢查安裝的插件版本和 JAR 包版本，調整為一致後即不會有出錯警告。

• 伺服器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件

• 設計器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件

3.2 啟動工程時

問題描述：

更新工程後，工程啟動時，當插件版本和 JAR 包要求的版本不匹配時，工程會禁用插件，管理者登入平台，平台會彈窗顯示版本不匹配。如下圖所示：

注：叢集環境下，多個節點都會進行匹配檢查。若基準節點先完成啟動，提醒時只使用基準節點的檢查結果，只進行一次提醒；若基準節點還未完成啟動，已有其他節點先完成啟動，則會進行多次提醒。

• 插件版本高於 JAR 包要求的版本時，平台訊息通知：插件 xxx 版本過高，已被系統禁用，請升級 JAR 包或安裝低版本插件。

• 插件版本低於 JAR 包要求的版本時，平台訊息通知：插件 xxx 版本過低，已被系統禁用，請更新插件。

解決方案：點選訊息內容，即可跳轉至「插件管理」頁面做相應處理，或在平台「系統訊息」處，通知內容後有「處理」跳轉連結，點選後可直接跳轉至「插件管理」頁面，管理者可對插件進行刪除或更新使得插件可用。如下圖所示：

• 伺服器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件

• 設計器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件

3.3 使用設計器時

問題描述：

若插件版本和本地設計器 JAR 包版本不匹配，開啟設計器時，設計器會彈窗提醒：以下插件與 JAR 包版本不匹配已被禁用

彈窗中詳細列舉了不匹配的插件，點選「立即處理」即可跳轉至「插件管理」頁面對插件做相應處理。如下圖所示：

設計器切換本地其他目錄時，也會檢查插件和工程 JAR 包是否匹配，不匹配會彈窗提醒。

注：遠端設計時，不檢查插件版本和工程 JAR 包版本資訊，即不匹配時不會彈窗提醒。

解決方案：點選立即處理，對插件進行刪除或更新使得插件可用。

• 伺服器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件

• 設計器插件刪除或更新請參考：伺服器插件管理-刪除插件、伺服器插件管理-更新插件