1. 概述
2. 插件管理介面異常
2.1 插件商店有新版本，是否更新
問題描述：
管理者登入數據決策系統，點選「管理系統>插件管理」，插件管理介面有時會彈窗提示：「插件商店有新版本，是否更新？」，如下圖所示：
原因分析&解決方法：
此時更新的是帆軟商城中插件，不會更新工程中已安裝的插件，點選「確定」按鈕即可。
2.2 插件管理介面空白
問題描述：
管理者登入數據決策系統，點選「管理系統>插件管理」，提示：「您還沒有插件商店的資源，是否下載？」
點選「確定」按鈕後，「插件管理」介面依然空白。如下圖所示：
原因分析&解決方法：
1）設計器和伺服器 JAR 包不一致，保持一致之後即可恢復正常。
2）使用者在本地或遠端工作區間中，勾選了「使用新插件管理器」按鈕。
注：「使用新插件管理器」按鈕具體介紹可參考 選項 中的 3.4 節內容。
外網使用者：外網使用者在插件管理頁面的彈窗上，點選確定按鈕後，清理瀏覽器快取，重新進入數據決策系統即可。
內網使用者：請聯絡技術支援獲取 upm 資料夾，將 upm 資料夾放到%HOME%\webapps\webroot\WEB-INF\assets資料夾下。
注：付費使用者請聯絡技術支援。技術支援聯絡方式：
線上支援：前往「服務」，選擇「線上支援」
電話：400-811-8890
2.3 應用商城介面空白/帆軟通行證無法登入
問題描述：
1）以管理者身分進入數據決策系統後，點選「管理系統>插件管理」，應用商城頁面空白，如下圖所示：
2）登入帆軟通行證時，提示「未知錯誤」。如下圖所示：
3）設計器中點選右上角登入，提示「網路連結失敗」。如下圖所示：
排查步驟一：查看外網地址是否開放
原因分析：伺服器沒有連外網。
解決方法：根據需要開放的外網地址，開放網路即可。詳情請參見：FineReport外網地址
排查步驟二：查看「連結地址管理中心」是否開啟
原因分析：伺服器可以通外網，在平台系統管理節點的「標準」 Tab 頁中關閉了連結地址管理中心按鈕，插件引擎模組無法使用。
解決方法：以管理者身分進入數據決策系統，點選「管理系統>系統管理>標準」，開啟「連結地址管理中心按鈕」，點選儲存。如下圖所示：
注1：遠端環境中若關閉連結地址管理中心按鈕，也將出現本節「問題描述」中的現象。
注2：連結地址管理中心按鈕的介紹請參見：標準 中的 2.2 節內容。
排查步驟三：查看伺服器系統時間與北京時間是否一致
原因分析：插件商城地址用的是北京時間，從插件管理登入的時候需要驗證token。token是按照使用者的系統時間生成的，登入時遠端伺服器會校驗傳過來的這個token是否正確，如果時間不對，就無法登入。
解決方法：伺服器系統時間與北京時間保持一致
3. 插件線上安裝失敗
3.1 報錯：connection time out
問題描述：
插件線上安裝失敗，報錯 connection time out
原因分析：
當前工程無法成功連結線上插件商城。
解決方法：
根據需要開放的外網地址，開放網路即可。詳情請參見：FineReport外網地址
3.2 插件線上安裝/更新無進度
問題描述：
在數據決策系統安裝/更新插件時卡住，不顯示進度條，不顯示「安裝完成」。重新整理頁面後，發現插件已經安裝/更新好了。
原因分析：
WebSocket埠被佔用了，無法主動給瀏覽器推播訊息。
解決方法：
開放 WebSocket 埠，詳情請參見：Websocket連接失敗 。
4. 插件本地安裝失敗
4.1 插件本地安裝/更新無進度
問題描述：
從本地選擇插件安裝包，安裝插件後，無安裝進度，不顯示「插件安裝成功」。
原因分析&解決方法：
1）插件安裝包過大，安裝較緩慢。請耐心等待即可。
2）工程環境無法連結安裝包所在的位置。例如無法連結外網等。開放網路路徑即可。
3）插件安裝目錄無權限，請確定使用者有以下目錄的讀寫執行的權限
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
4.2 檔案上傳失敗/未找到安裝包 Request Entity Too Large
問題描述：
從本地安裝插件，提示「檔案上傳失敗」/「未找到安裝包」，F12查看日誌發現報錯「413 Request Entity Too Large」。
原因分析：
上傳的插件安裝包過大，一般Linux預設上傳檔案的上限大小為1M。
解決方法：
1）不使用本地安裝方法，改用「手動安裝」方法，詳情請參見：伺服器插件管理
2）修改Linux的配置檔案
找到 nginx.conf 檔案，更改body size
更改後 nginx -s reload 重新載入一下，如果命令載入不成功，則需要重啟 Linux 伺服器進行載入
5. 插件安裝後使用失敗
問題描述：
數據決策系統（伺服器端）安裝插件後，設計器端遠端連結該工程，無法使用插件功能。
排查步驟一：檢查本地設計器和遠端伺服器是否都安裝了插件
對於設計器和伺服器都會用到的插件，要求伺服器端和設計器端都要安裝：
若伺服器端安裝了插件，設計器端沒有安裝插件，則插件不會生效，需要切換到本地進行插件安裝。
若伺服器端和設計器端均安裝了插件，伺服器端的插件下載、刪除、禁用不會立即生效，需要等幾分鐘才會生效。
若伺服器端和設計器端均安裝了插件，設計器切換到本地，禁用該插件，不影響遠端連結時伺服器端的插件使用。
注：設計器插件有兩個路徑，兩個路徑都需要有插件包，否則安裝無效：
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
若%FR_HOME%\plugins目錄下沒有插件/插件不生效，一般會報錯「Plugin not installed at designer」，請卸載重裝。
排查步驟二：檢查本地設計器和遠端伺服器插件版本是否一致
原因分析：若設計器端和伺服器端均安裝了插件，但是插件版本不一致，可能導致插件功能失效。
解決方法：將本地設計器和遠端伺服器插件版本升級到一致。
排查步驟三：檢查插件版本是否最新
如果插件版本不是最新版，可將本地設計器和遠端伺服器插件版本升級到最新，再進行測試。
注：大部分行動端插件和HTML5行動端展現插件的版本之間有依賴關係。
請參照具體的插件說明文檔，確定所使用的行動端功能插件和HTML5行動端展現插件之間的版本互相支援。
排查步驟四：檢查本地設計器和遠端伺服器JAR包版本是否一致
原因分析：如果本地設計器和遠端伺服器JAR包版本不一致，會帶來很多問題，也有可能會導致插件失效。
解決方法：將本地設計器和遠端伺服器JAR包版本升級到一致，升級方式請參見：工程小版本升級指南
排查步驟五：檢查遠端伺服器工程中是否存在冗餘JAR包
原因分析：一般來說，遠端伺服器工程%FR_Home%/webapps/webroot/WEB-INF/lib目錄下不應該存在fine-report-designer-11.0.jar檔案。若遠端工程沒有刪除這個JAR包，會導致工程報錯以及插件不生效。
解決方法：請備份JAR包後，將遠端伺服器工程%FR_Home%/webapps/webroot/WEB-INF/lib目錄下的fine-report-designer-11.0.jar檔案刪除，重啟報表工程後再次嘗試。
排查步驟六：檢查是否存在歷史版本插件包
原因分析：若工程下同時存在多個版本的插件包，可能會導致插件不生效。
解決方法：
1）檢查設計器下兩個路徑內的插件包，刪除冗餘插件包。
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
2）檢查伺服器工程下的插件包，刪除冗餘插件包。
%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins
排查步驟七：檢查資料夾權限
伺服器工程的啟動使用者，需要對WEB-INF檔案及其子檔案有讀寫執行的權限。
6. 插件過期
問題描述：
提示XXX插件過期，請前往帆軟應用中心進行購買。
原因分析：
使用者所使用的報表工程是已註冊的，對未購買授權的付費插件，使用者可免費試用90天，90天后需要購買授權方可使用。
FineReport工程未註冊時，插件可免費使用，無需進行授權。
FineReport工程註冊後，免費插件可正常使用，無需進行授權。
FineReport工程註冊後，購買了授權的付費插件，使用者可正常使用。
FineReport工程註冊後，未購買授權的付費插件，使用者可免費試用90天，90天后需要購買授權方可使用。
解決方法：
購買插件授權並新增到報表工程中即可，詳情請參見：插件註冊
