錯誤代碼匯總及解決方案

1：報表

2：平台

3：資料連結

6：BI

7：FVS

1：報錯日誌

2：提示日誌

1：不支援的功能

2：使用錯誤

3：異常資訊

4：系統提示

前 3 位相當於劃分錯誤類別，後面這幾位才是將每個錯誤進行編碼

注：在 FVS 中，第 4 位用作前後臺分類，0 代表後臺，1 代表前臺

列式引擎只支援單個資料集。若資料來自不同的地方，可以在定義資料集時自行將需要的資料整合到一個資料集中使用

請您檢查報表中是否使用了條件屬性改變列高或欄寬，如下圖所示：

若有請您刪除對應的條件屬性設定或關閉列式引擎

請您檢查報表中是否對資料進行了形態設定，如下圖所示：

若有請您取消形態設定或關閉列式引擎

請您檢查報表中是否對資料進行了其它擴展屬性設定，如下圖所示：

列式引擎不支援無擴展和從左到右擴展屬性，可以修改報表，使報表中只有從上到下的擴展屬性，也可以取消使用列式引擎功能

請您檢查報表中是否插入了懸浮元素，例如懸浮圖表等。若有請您刪除懸浮元素或關閉列式引擎。如下圖所示：

請您檢查報表中是否開啟了報表換列換欄，如下圖所示：

若有請您關閉分換欄或關閉列式引擎

請您檢查報表中是否使用了除純色外的儲存格背景，如下圖所示：

 若有請修改儲存格背景

請您檢查報表中的頁首頁尾是否為圖片和文字的組合，如下圖所示：

若需要匯出 word 後的文字可編輯，需要定義頁首時只用純正文

1）請您檢查報表中的圖片，並調整圖片

2）調整範本匯出屬性中的解析度

FVS 視覺化看板中使用了未註冊的組件

1）確認是否已購買對應組件功能，功能點的說明和未購買影響請參見：註冊管理 第四章

2）若註冊資訊中顯示該功能可用，但實際使用時仍然報沒有功能，可能您獲得的 lic 版本與報表版本不一致，此時需要聯絡商務人員進行覈實

您的 FineReport 工程使用了加密鎖認證，伺服器上需要一直插着 USB API的加密鎖。出現此提示時，請檢查加密鎖有沒有插好，加密鎖驅動有沒有正常載入。

詳情請參見：加密鎖認證

1）請檢查範本中資料連結配置能否連結成功。請參考：通用資料連結常見問題

2）檢查範本中是否使用了動態參數，請參考：超級連結常見問題

需要在 jvm 環境配置的地方，加上相應的位置即可。

例如：tomcat JVM_OPTS = "$JVM_OPTS;-Dxxx=絕對路徑"

範本內容區域中存在儲存格左父格關係不連續，請您根據提示的儲存格檢查左父格的關系，如下圖所示：

標記匯入的資料區域存在沒有設定為列表的資料列，請您檢查標記區域的擴展設定，如下圖所示：

1）資料量過大，請參考：大數據量範本排查思路 

2）笛卡爾積，請參考：防止填報笛卡爾積 

3）SQL 執行時間過長，請參考：範本限制 

4）儲存格超過限制，請參考：範本限制 

請確認當前使用的資源是否被刪除或行動。可透過「伺服器>fvs資源中心」，點選重新整理資源，重新上傳或選擇其他資源

錯誤說明：配置檔案伺服器的情況下，設計器中編輯複用資源，檔案伺服器的讀寫是非同步的。如果有複用資源檔案到檔案伺服器的任務沒有執行完，此時點選重新整理資源，會拋錯給前臺，是正常現象

解決方案：等待幾分鐘重新重新整理即可

1）請參考 監視視頻無法播放排查步驟 進行排查

2）若排查後問題仍然存在，請您聯絡官方的技術支援

1）使用瀏覽器的開發者工具查看是否存在控制檯錯誤資訊，按照錯誤提示檢查

2）檢查組件是否與當前使用的插件版本相容，可更新插件至最新版本查看問題是否存在

3）若問題仍然存在，請您聯絡官方的技術支援

併發數指的是允許同時存取報表伺服器的 IP 個數

1） FineReport 工程未註冊或者註冊允許已經過期

原因分析：未註冊工程的併發數固定為 2 ，即同時只能有 2 個不同的 IP 存取伺服器。若超過2個併發，則會出現此提示。

解決方法：您可聯絡銷售進行正式註冊，或等待其他IP跳出後進行存取。

未註冊的影響請參見：註冊簡介

2）FineReport 工程已註冊

原因分析：說明當前系統存取的IP個數已超過最大併發數限制。

解決方法：您可聯絡銷售增加最大併發數，或等待其他IP跳出後進行存取。

併發數原理相關介紹請參見：報表併發數的原理 

您未購買該功能需要的功能點，請聯絡銷售增購此功能點。

功能點的說明和未購買影響請參見：註冊管理 第四章

前臺請求的認證token逾時，預設有效時間為一小時，可以在系統管理中配登入逾時時間

詳情請參見：登入逾時

平台檔案資料集的預設最大檔案限制為20M，上傳的檔案超過此大小時會出現報錯。

使用者可F12，在瀏覽器控制檯查看具體限制資訊，關鍵詞為「檔案過大，上限為XXX」

出現該異常的場景有：

1）資料連結重新命名，不允許和其他資料連結重名

2）編輯目錄，不允許和其他目錄重名

3）使用者、部門、角色重新命名，不允許相同命名

新增列權限的時候，發現該表下對目標角色依舊存在對應的列權限了.頁面操作應該不會出現，查詢表 fine_pack_filter 排查

1）「管理系統>使用者管理」中存在該使用者，但是使用者被禁用

若該使用者被禁用時線上，則會被立刻踢出，同時丟擲該異常

若該使用者被禁用時不線上，登入時會提示「帳號不可用」

解決方法：聯絡系統管理者，解除禁用

2）「管理系統>使用者管理>平台使用使用者」開啟限制，但該使用者不在「PC端使用使用者」中

解決方法：聯絡系統管理者，將該使用者新增到「管理系統>使用者管理>平台使用使用者>PC端使用使用者」中

3）管理者在對系統進行註冊時，會踢出當前正登入使用者，並丟擲該異常

解決方法：等待管理者註冊結束即可正常登入

此場景報錯故意模糊化，防止出現安全問題

可能出現的場景：

1）輸入帳號不存在

2）輸入使用者密碼不正確

3）使用者校驗失敗

4）角色權限認證失敗

5）自訂登入API呼叫失敗

6）finedb沒有載入到該使用者

匯入樹資料集前請清空原有資料

注：該異常已棄用，目前匯入樹資料集不會清空原有使用者。

匯入使用者時切換了加密方式，會傳回該異常。

前臺會根據此異常，彈出清空使用者的警告。

在兩種情況下會出現此異常：

1）根據檢驗碼重置密碼時，新密碼與舊密碼相同，需要重新填寫

2）根據舊密碼修改密碼時，新密碼與舊密碼相同，需要重新填寫

請輸入與舊密碼不相同的新密碼

管理者修改了 使用者身分驗證 方式，已登入的使用者會被踢出系統

此時會丟擲該異常，無需處理，待管理者修改完成後，使用者即可重新登入

在「同步使用者」管理時，管理者若關閉同步使用者，或切換同步使用者資料集，之前的同步使用者會被踢出登入

「管理系統>使用者管理>平台使用使用者」開啟了限制，但該使用者不在「行動端使用使用者」中

解決方法：聯絡系統管理者，將該使用者新增到「管理系統>使用者管理>平台使用使用者>行動端使用使用者」中

自訂角色名稱長度超出最大限制（最大為200）

減少自訂角色名稱字元長度

同步來源資料下不可以存在手動來源的資料
新增使用者、新增部門等情況會檢查資料源，需要刪除掉手動來源的資料

同步使用者高度依賴資料源，若資料源出現問題，例如被惡意清空資料庫表，會導致同步到系統中的使用者被清空，操作無法逆轉。

因此 FineReport 提供同步熔斷策略。10.0.18 及之後版本的報表工程，新增「異常資料中斷同步」按鈕。

管理者開啟「異常資料中斷同步」後，可設定使用者數量減少達到X%，停止同步。X為1-100的正整數。

例如系統中原有100個同步使用者（不包含手動新增/匯入的使用者數），設定為30%，即同步減少30（100*30%）個使用者及以上，就會停止本次同步。

詳情請參見：同步使用者 5.4 節

儲存同步使用者配置時，cron運算式非法。

填寫正確的cron運算式

1）管理目錄不能拖動到首頁

2）首頁不能拖動到管理目錄

3）目標位置不可以和本身衝突

存取目錄時報錯，您選擇的目錄節點不存在，請重新選擇

原因分析：傳入後臺的entryId在資料庫中無法找到導致

解決方案：查看請求目錄的請求，/entry/access/{entryId}中的路徑參數entryId在資料庫中fine_authority_objcet中無法找到

主要是token失效和解析登入token失敗的場景

檢查token的正確性和是否過期

後臺做非法字元檢查，思路是將合法格式列出來，如果對應內容不屬於合法的格式，就丟擲異常

這個校驗是後臺校驗，前臺無法獲取到哪些是合法字元

請刪除特殊字元，正確輸入格式

獲取使用者上一次的登入資訊失敗，說明當前使用者是第一次登入，無上次存取記錄

管理者可在 finedb 的 fine_last_login 中的 userid 欄位查看下，確認是否有該使用者

部分使用者在未登入的情況下，沒有自動進行重新登入，進而導致FR的token缺失，產生報錯

finedb裏面設定欄位ServerConfig.tokenFromCookie為true

設定方法請參考：FINE_CONF_ENTITY視覺化配置

設定範本認證配置項，如果遮蔽了數字簽章功能，但是傳過來的認證方式還是數字簽章認證丟擲的錯誤

修改 TemplateAuthConfig.digitalAuthAvailable 值為 true，開啟數字簽章功能

開啟叢集時平台資料庫未遷移產生的報錯

開啟叢集配置前先遷移到外接資料庫，請參考：配置外接資料庫

開啟叢集或設定狀態伺服器時狀態伺服器連不上報的錯

檢查狀態伺服器資訊是否正確，服務是否啟動，確定狀態伺服器連結成功

有以下四種情況：

1）使用檔案伺服器時開啟叢集，檔案伺服器連不上

4）重新整理檔案伺服器快取時檔案伺服器連不上

檢查檔案伺服器配置資訊，確定檔案伺服器連結成功

BI工程設定Spider的時候丟擲的錯

spider叢集服務沒有起起來

成功切換狀態伺服器時，需重新登入，這是一個提示，重啟服務即可

正在備份的時候，又觸發了一次備份

請等待當前備份結束

設計器啟動的平台，不支援升級  JAR 包，請用設計器內的更新升級功能進行升級

詳情請參見：小版本升級指南 2.1節

資料連結id在資料庫中不存在

屬於產品邏輯，不用在意；一般是髒資料，刪掉就行

錯誤程式碼:21300103 資料連結數量超出lic限制

說明後臺收到的資源檔案損壞，請檢查資源檔案zip包中的entity.json中是否有資料

若無，說明上傳的檔案有問題

若有，請嘗試更換瀏覽器

請聯絡帆軟技術支援並提交產品bug

資源匯入時，匯入的資源需要的工程版本和當前工程版本不匹配

請確定工程版本一致

錯誤程式碼:21300103 檢驗碼逾時

橫向間距小於100或縱向間距小於50

系統管理>標準配置>標準參數配置websocket ssl時路徑或密碼錯誤，檢查ssl的金鑰路徑和密碼是否正確

系統管理>標準配置>加密算法，切換前後相同的加密方法，請更換加密方法

1、ssoToken解析失敗

系統管理>整合後臺單點登入，解密測試測試當前ssoToken是否正確；若解密失敗查看說明文檔重新生成ssotoken即可

2、登入逾時，請重新登入

系統管理>整合後臺單點登入，查看說明文檔重新生成ssoToken

1、當前地址無法存取，請確定憑證有效或者手動將憑證匯入到 JDK 憑證信任庫

將CAS伺服器的SSL憑證匯入帆軟伺服器的JDK憑證信任庫

2、當前地址無法存取，請輸入與憑證匹配的host

SSL憑證中的地址與當前地址不匹配，請檢查

3、請攜帶帳號密碼參數: 形如/cas/reset?username=xxx&password=xxx

CAS單點配置重置API（/cas/reset）需要攜帶使用者資訊，請新增username和password參數

4、僅超管可以操作

CAS單點配置重置API（/cas/reset）只支援超管

錯誤程式碼：22400001 帳號不能為空

錯誤程式碼：22400012 手機未與該帳號綁定

密碼強度限制

請檢查當前 Web 應用是否被多個伺服器同時使用

1.KILL -9 清理進程，刪除db.lck然後重啟

2.在 /conf/context.xml 的 </Context>前新增以下內容（大小預設是1024，單位是KB）：
<Resources cachingAllowed="true" cacheMaxSize="100000" />
重啟重新整理下

錯誤程式碼：11300111 當前密碼已失效

開啟叢集配置前先遷移到外接資料庫，方法參照文檔：

配置外接資料庫

可能的原因：

• 使用檔案伺服器時開啟叢集，檔案伺服器連不上

• 設定、測試檔案伺服器時檔案伺服器連不上

• 設定快取模式時檔案伺服器連不上

• 重新整理檔案伺服器快取時檔案伺服器連不上

需要檢查檔案伺服器配置資訊，確定檔案伺服器連結成功

錯誤程式碼：11300105 遠端設計帳號密碼錯誤