錯誤程式碼匯總

1：報表

2：平台

3：資料連結

6：BI

7：FVS

8：問答BI

1：報錯日誌

2：提示日誌

1：不支援的功能

2：使用錯誤

3：異常資訊

4：系統提示

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

倒數第 3 位

1：spider

2：安裝部署

3：功能使用

4：資料更新

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

原因分析：

工程註冊時，未購買「BI-分佈式引擎」功能點。出現該報錯說明需要使用該功能。

解決方案：

請先查閱「註冊管理」，瞭解該功能點的使用場景和影響情況。

若確認需要該功能，請聯絡銷售進行增購。

原因分析：

工程實際需要的spider分佈式節點數，大於註冊時購買的「spider分佈式節點數」。

解決方案：

超管存取http://IP:埠/webroot/decision/v10/register/info/license，查看註冊時的限制值。

若分佈式節點數達到限制值，則將無法新增節點，新新增的節點不顯示。

若確認需要新增節點，請聯絡銷售進行增購。

原因分析：

工程註冊時，未購買「BI-圖表」功能點。出現該報錯說明需要使用該功能。

解決方案：

請先查閱「註冊管理」，瞭解該功能點的使用場景和影響情況。

若確認需要該功能，請聯絡銷售進行增購。

原因分析：

工程註冊時，未購買「靜態圖表」功能點。出現該報錯說明需要使用該功能。

解決方案：

請先查閱「註冊管理」，瞭解該功能點的使用場景和影響情況。

若確認需要該功能，請聯絡銷售進行增購。

原因分析：

工程註冊時，未購買相關功能點。出現該報錯說明需要使用該功能。

解決方案：

行動端分為App、HTML5 端、HTML5 整合（微信、釘釘、第三方App整合）存取單張範本/報表目錄。

根據使用場景，需要註冊不同的功能點，請先查閱「註冊管理」，瞭解使用場景所需的功能點。

若確認需要該功能，請聯絡銷售進行增購。

原因分析：

當計算任務使用過多的堆記憶體時，可能由於應用記憶體上限溢位導致引擎頻繁當機
因此當FineBI整體的計算引擎記憶體使用超出限制時，直接報錯提示

解決方案：

1）調大FineBI工程的堆外記憶體

2）正在執行的請求過多，重新整理重試即可

可能出現該報錯的場景：

1）分析文檔欄位標紅報錯：當前引擎記憶體不足，無法進行計算

2）組件快取報錯：當前引擎記憶體不足，無法進行計算。建議點選右上角“更新”

3）組件預覽報錯：當前引擎記憶體不足，無法進行計算。請稍後重新整理頁面

4）預覽表時報錯：當前引擎記憶體不足，無法進行計算。請稍後重新預覽

原因分析：

當計算任務使用過多的堆記憶體時，可能由於應用記憶體上限溢位導致引擎頻繁當機
因此當單個任務的計算引擎記憶體使用超出限制時，直接報錯提示

解決方案：

1）調大FineBI工程的堆外記憶體

2）正在執行的請求過多，重新整理重試即可

可能出現該報錯的場景：

1）分析文檔欄位標紅報錯：單次計算使用記憶體超過限制，可能資料量過大或計算太複雜，請進行優化

2）組件快取提示面板：計算複雜佔用了過多記憶體，觸發系統保護機制。建議點選右上角“更新”

3）組件預覽報錯：單次計算使用記憶體超過限制，可能資料量過大或計算太複雜，請進行優化。請稍後重新整理頁面

4）預覽表時報錯：單次計算使用記憶體超過限制，可能資料量過大或計算太複雜，請進行優化。請稍後重新預覽

原因分析：

這是資料庫相關問題導致的更新出錯

解決方案：

按照更新出錯日誌，找到對應的資料表，找到資料表對應的資料連結

按照「資料連結支援範圍」找到對應類型的資料連結指導文檔，檢查資料連結和資料庫配置

原因分析：

存取hostname失敗，拋java.net.UnknownHostException異常

解決方案：

配置spider叢集的hostname

原因分析：

IP 埠配置錯誤

解決方案：

修改被佔用的埠：修改 FineBI 工程埠

HDFS 空間不足

擴展 HDFS 的儲存空間

Alluxio 空間不足

擴展 Alluxio 的空間配置

Alluxio Worker 掛了或者滿了（可能存在其他原因）

檢查 Alluxio 服務

1）沒有開啟 spark.shuffle.service 服務

2）Spark 的tmp路徑空間不足

在 BI 中新增參數或修改 Spark 相應的 tmp 目錄配置

Alluxio 的 Worker 掛掉或 temp block id 重複的問題

檢查 Alluxio 服務，檢查block id

hdfs datanode 掛了

檢查 HDFS 服務

spark 啟動失敗 

1）spark_driver_host 參數可能配置出錯， IP 不對

2）hosts 檔案中 localhost 對應了多個 IP（單機版），叢集版則可能是本機同一個 hostname 配置了多個 IP 或者 hostanme 與 IP對應錯誤。

3）Spark 服務異常。檢查 spark 的 web 頁面狀態。（必須要有一個 ALIVE狀態的節點）

4）檢查其他導致失敗因素

BI 端記憶體不足

修改 BI 記憶體

更新 Excel 檔案類型不一致

檢查更新的檔案類型

欄位名或表名長度超出 xxx 限制，無法儲存

將欄位名或表名改短

報錯資訊空白

排查報錯原因

xx 業務包，xx 表，xxx 欄位名重複

修改欄位名，使欄位名不重複

資料庫連結失敗

檢查資料庫連結

硬碟空間不足

硬碟擴容

Linux：too many open files

調整 Linux 開啟檔案個數

空欄位建立聯動

檢查表間聯動關係

61300417

分析使用者的自助資料集由於在計算程式或生成程式中超出資料量的限制，不包含中位數和去重記錄數的出錯情況

產品中有提示文案。主要是透過匯總資料或者新增過濾的方式減少資料來達到完成計算和生成的效果

計算程式中參與計算的指標數量太多

減少指標數量

儀表板去重計數/中位數計算超出資料限制量

1）如果使用的是資料庫表：開啟實時資料

2）利用自主資料集裏的「匯總-去重計數」操作

3）若使用併發不大可嘗試調小計算臨界值，臨界值內計算不會報錯：「DistributedOptimizationConfig.spiderConfig.spider_distinct_median_threshold」

5.1.12之前的工程版本，預設值為100，含義為1/100的 BI 記憶體

5.1.12及之後的工程版本，預設值為25，含義為1/25的 BI 記憶體

4）修改配置資料庫的參數，修改後所有去重計數都會變慢，但不會報錯

DistributedOptimizationConfig.spiderConfig.spider_distinct_use_spark_sql=true

5）若調整後仍然報錯，說明計算量非常大，建議對儀表板增加明細過濾條件，或使用資料處理的自助資料集來進行計算。

不能因為某個使用者不合適的操作導致生成了一個非常大的資料，影響其他使用者使用，甚至將磁碟空間佔滿

減少生成的資料數量

61310001

SQL 資料集配置錯誤-連結失敗

packagename 為空

tablename 為空

SQL 語句為空

dataLinkName 為空

異常導致新增失敗

EXCEL 資料集配置錯誤

欄位名和欄位順序不一致

EXCEL 資料集配置錯誤

欄位個數和類型不一致

欄位類型錯誤

EXCEL 資料集配置錯誤

僅支援格式：xls、csv、xlsx

sheet頁錯誤

EXCEL 資料集配置錯誤

只讀取第一個 sheet 的資料，請確定從第一個儲存格開始沒有：複雜函式或者 VBA 編程等

sheet表頭錯誤

EXCEL 資料集配置錯誤

第一欄為欄位名，第二行開始為欄位的字；請確定第一欄沒有合併儲存格。

SQL 資料集配置錯誤-SQL 語句不正確

packagename 為空

tablename 為空

SQL 語句為空

dataLinkName 為空

異常導致新增失敗

-

獲取資料錯誤

SQL語句 “SELECT xxxx” 執行失敗，欄位資訊與新增表時不一致

請檢查資料庫

資料更換邏輯，存在聯動的表中某一張表更新失敗

檢查對應的業務包下的資料表

當基礎表實時性被修改後，如果出現分析表的狀態轉換（從抽取狀態轉換為實時），提示狀態變化。

增加前端提示：該表正在被其他分析表使用，如果改變實時性，會導致聯動的分析表實時性轉換（需要設計）

當前表配置修改，導致抽數的表需要重新更新資料

來源表配置修改，導致子表抽數的表需要重新更新資料

聯動關係不一致

檢查表間聯動關係，重新修改編輯

報錯組件的組件配置/表配置/範本配置，方便定位報錯的組件，其中：

• target：表名/組件id

• comment：錶轉義名/ 組件名