1. 版本编辑
| FineBI 版本 |
|---|
| 5.1 |
2. 描述编辑
在使用 FineBI 的过程中会遇见各种各样的错误，此时，可以查看 FineBI 的系统日志%FineBI%/logs/fanruan.log寻找报错原因，解决问题。
3. 报错分类编辑
日志以 8 位数字代码标记，如下图所示：
3.1 一级分类
第 1 位代表模块，其中 1-报表、2-平台、3- 数据连接、6-BI
3.2 二级分类
第 2 位为日志大类，其中 1-报错日志；2-提示日志
3.3 三级分类
第 3 位为日志小类，1-不支持的功能点；2-使用错误；3-异常信息；4-系统提示
3.4 四级分类
第 4-8 位具体情况细分
4. 报错日志编辑
4.1 异常信息
| 错误代码 | 可能原因 | 解决方案 |
|---|---|---|
61310001 SQL 数据集配置错误-连接失败 |
| |
| 61310047 SQL 数据集配置错误-SQL 语句不正确 | ||
| 61310039 EXCEL 数据集配置错误-字段名和字段顺序不一致 | ||
| 61310040 EXCEL 数据集配置错误-字段个数和类型不一致 | ||
| 61310041 EXCEL 数据集配置错误-仅支持格式：xls、csv、xlsx | ||
| 61310042 EXCEL 数据集配置错误-只读取第一个 sheet 的数据，请确保从第一个单元格开始没有：复杂函数或者 VBA 编程等。 | ||
61310043 EXCEL 数据集配置错误- 第一行为字段名，第二行开始为字段的字；请确保第一行没有合并单元格。 | ||
| 错误代码：61300102 无法使用端口XXXX | IP 端口配置错误 | 检查并配置 IP 端口 |
| 61300104 sprider 多节点文件存储空间不足 | hdfs 空间不足 | 扩展 hdfs 的存储空间 |
| 61300105 spider 多节点内存存储空间不足 | alluxio 空间不足 | 扩大 alluxio 的空间配置 |
| 61300106 spider 多节点内存工作启动异常 | alluxio worker 挂了或者满了（可能存在其他原因） | 检测 alluxio 服务 |
| 61300107 没有开启 shuffle.service 服务或计算引擎 tmp 空间不足 |
| 在 BI 中添加参数或修改 spark 相应的 tmp 目录配置 |
| 61300108 spider_calculation_engineblock 写入失败 | alluxio 的 worker 挂掉或 temp block id 重复的问题 | 检查 alluxio 服务，检查block id |
| 61300109 sprider 多节点文件数据节点异常 | hdfs datanode 挂了 | 检查 hdfs 服务 |
| 61300110 计算引擎初始化失败 | spark 启动失败
| 检查其他导致失败因素 |
| 61300111 BI内存分配不足 | BI 端内存不足 | 修改 BI 内存 |
| 61300112 计算引擎临时文件目录空间不足 | 扩展 spark 临时文件目录的磁盘空间 | |
| 61300301 文件类型异常 | 更新 Excel 文件类型不一致 | 检查更新的文件类型 |
| 61300400 xx 数据库（和 xx 数据库）连接失败，请检查数据连接 | 数据库连接失败 | 检查数据库连接 |
| 61300401 硬盘空间不足 | 硬盘空间不足 | 硬盘扩容 |
| 61300403 打开的文件过多，超过 linux 系统默认最大打开文件数 | linux：too many open files | 调整 Linux 打开文件个数 |
| 61300404 xx 表的 xx 字段（xx表的xx字段）为空，无法成功生成关联关系 | 空字段建立关联 | 检查表间关联关系 |
61300417 自助数据集计算超出【单元格】数据量限制，无法成功计算和更新 | 分析用户的自助数据集由于在计算过程或生成过程中超出数据量的限制，不包含中位数和去重记录数的出错情况 | 产品中有提示文案。主要是通过汇总数据或者添加过滤的方式减少数据来达到完成计算和生成的效果 |
| 61300423 自助数据集计算超出【行】数据量限制，无法成功计算和更新 | ||
| 61300424 自助数据集计算超出【内存】数据量限制，无法成功计算和更新 | ||
| 61300418 中位数或去重记录数计算超出数据量限制，无法成功计算和更新 | 分析用户的自助数据集由于在计算中位数或去重记录数时超出数据量限制 | |
| 61300419 需要计算的指标数量超出限制，无法成功计算和更新 | 计算过程中参与计算的指标数量太多 | 减少指标数量 |
| 61300420 去重计数/中位数计算超出数据限制量 | 仪表板去重计数/中位数计算超出数据限制量 | 1、通过过滤组件或者在自助数据集中增加过滤条件减少数据量即可 2、若内存充足可尝试调小。 DistributedOptimizationConfig.spiderConfig.spider_distinct_median_threshold参数，默认为100 ，含义为 1/100 的 BI 内存，最低调到 50。 3、 若内存不充足或调整后仍然报错，说明计算量非常大，可牺牲速度来计算出结果：
|
| 61300421 您的自助数据集数据量超过xxx单元格，无法成功更新，请减少需要更新的数据。如减少字段，继续对数据进行过滤，或者对数据进行分组汇总 | 不能因为某个用户不合适的操作导致生成了一个非常大的数据，影响其他用户使用，甚至将磁盘空间占满 | 减少生成的数据数量 |
| 61300422 您的自助数据集数据量超过xxx行，无法成功更新，请减少需要更新的数据。如减少字段，继续对数据进行过滤，或者对数据进行分组汇总 | 减少生成的数据数量 | |
| 61300302 字段名或表名长度超出 168 个字符的限制，无法保存 | 字段名或表名长度超出 xxx 限制，无法保存。 | 将字段名或表名改短 |
| 61300303 | 报错信息空白 | 排查报错原因 |
| 61300304，xx 业务包，xx 表，xxx 字段名重复 | xx 业务包，xx 表，xxx 字段名重复 | 修改字段名，使字段名不重复 |
4.2 使用错误
| 错误代码 | 问题原因 | 解决方案 |
|---|---|---|
| 61200401 | 数据库相关问题导致的更新出错 | 检查数据库配置等相关 |
4.3 提示日志
| 提示代码 | 提示原因 | 解决方案 |
|---|---|---|
| 62400401 xx 业务包下的 xx 表生成失败，xx 关联（xxx关联=关联缓存的名字）将使用历史数据生成 | 数据替换逻辑，存在关联的表中某一张表更新失败 | 检查对应的业务包下的数据表 |
| 62400402 因 xx 业务包中的 xx 表实时性被修改，其关联的 xx 业务包中的 xx 分析表的实时状态转换。 | 当基础表实时性被修改后，如果出现分析表的状态转换（从抽取状态转换为实时），提示状态变化。 | 增加前端提示：该表正在被其他分析表使用，如果改变实时性，会导致关联的分析表实时性转换（需要设计） |
| 62400403 当前表有修改，需要重新更新数据 | 当前表有修改，需要重新更新数据 | 当前表配置修改，导致抽数的表需要重新更新数据 |
| 62400404来源表有修改，需要重新更新数据 | 来源表有修改，需要重新更新数据 | 来源表配置修改，导致子表抽数的表需要重新更新数据 |
| 62400000 | 功能点获取数据请求正常 | |
| 62400001 获取组件数据时发生错误 | 获取数据错误 | |
| 62400002 获取组件数据时不完整 | 数据缺失 | |
| 62400003 没有权限获取该组件的数据 | 没有权限 | |
| 62400004 该组件没有数据 | 没有数据 | |
| 62400005 数据配置不全 | 数据配置不全 | |
| 62400006 最大行数不能超过100W，请调整维度字段或联系管理员 | 汇总组件展示数据量超出限制 | |
| 62400405 xx 业务包中 xx 数据表的 xx 字段（和 xx 业务包 xx 数据表的 xx 字段）不符合一对多/多对一/一对一对应关系，无法成功生成关联关系 | 关联关系不一致 | 检查表间关联关系，重新修改编辑 |