在使用 FineBI 的過程中會遇見各種各樣的錯誤，此時，可以查看 FineBI 的系統日誌%FineBI%/logs/fanruan.log尋找報錯原因，解決問題。
錯誤代碼以 8 位數字代碼標記，如下圖所示：
第 1 位代表模塊
1-報表
2-平台
3- 資料連接
6-BI
第 2 位為日誌大類
1-報錯日誌
2-提示日誌
第 3 位為日誌小類
1-不支持的功能點
2-使用錯誤
3-異常信息
4-系統提示
倒數第 3 位
1-spider
2-安裝部署
3-功能使用
4-資料更新
資料庫相關問題匯致的更新出錯
檢查資料庫配置等相關
IP 端口配置錯誤
檢查並配置 IP 端口
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 資料集配置錯誤
字段名和字段順序不一致
字段個數和類型不一致
字段類型錯誤
僅支持格式：xls、csv、xlsx
sheet頁錯誤
只讀取第一個 sheet 的資料，請確保從第一個單元格開始沒有：複雜函數或者 VBA 編程等
61310043
sheet表頭錯誤
第一行為字段名，第二行開始為字段的字；請確保第一行沒有合併單元格。
SQL 資料集配置錯誤-SQL 語句不正確
-
獲取資料錯誤
SQL語句 “SELECT xxxx” 執行失敗，字段信息與添加表時不一致
請檢查資料庫
資料替換邏輯，存在關聯的表中某一張表更新失敗
檢查對應的業務包下的資料表
當基礎表實時性被修改後，如果出現分析表的狀態轉換（從抽取狀態轉換為實時），提示狀態變化。
增加前端提示：該表正在被其他分析表使用，如果改變實時性，會匯致關聯的分析表實時性轉換（需要設計）
當前表配置修改，匯致抽數的表需要重新更新資料
來源表配置修改，匯致子表抽數的表需要重新更新資料
關聯關係不一致
檢查表間關聯關係，重新修改編輯
5.1.13 及之後版本的 BI 工程，當組件預覽、資料表更新、資料表預覽、資料表編輯時，若出現前端報錯，則支持匯出相關係統日誌和文件。
5.1.15 及之後版本的 BI 工程，新增 SQL表保存、自助資料集保存時，若出現前端報錯，則支持匯出相關係統日誌和文件。
點擊報錯的「詳細信息」，第一行顯示「匯出日誌」按鈕，點擊「匯出日誌」即可匯出完整報錯信息。
解壓匯出日誌壓縮包，包含以下內容：
報錯組件的組件配置/表配置/範本配置，方便定位報錯的組件，其中：
target：表名/組件id
comment：錶轉義名/ 組件名