1. 概述
1.1 版本
| FineBI 版本 | 功能变更 |
|---|---|
| 5.1 | - |
| 5.1.13 | 前端报错时，支持导出相关系统日志和文件 |
| 5.1.15 | 新增支持 SQL表保存、自助数据集保存报错时，可导出相关系统日志和文件 |
1.2 应用场景
本文提供 FineBI 常见的错误代码汇总，方便您快速定位到错误并找到解决方案。
1.3 代码说明
在使用 FineBI 的过程中会遇见各种各样的错误，此时，可以查看 FineBI 的系统日志%FineBI%/logs/fanruan.log寻找报错原因，解决问题。
错误代码以 8 位数字代码标记，如下图所示：
报错代码每一位代表的含义如下：
| 代码位数 | 数字含义说明 |
|---|---|
| 第 1 位：代表模块 | 1：报表 2：平台 3：数据连接 6：BI |
| 第 2 位：代表日志类型 | 1：报错日志 2：提示日志 |
| 第 3 位：代表错误定位 | 1：不支持的功能 2：使用错误 3：异常信息 4：系统提示 |
| 第 4~8 位：代表错误编码 | 前 3 位相当于划分错误类别，后面这几位才是将每个错误进行编码 倒数第 3 位 1：spider 2：安装部署 3：功能使用 4：数据更新 |
2. 不支持的功能
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61100001 | 没有spider引擎lic异常 | 原因分析： 工程注册时，未购买「BI-分布式引擎」功能点。出现该报错说明需要使用该功能。 解决方案： 请先查阅「注册管理」，了解该功能点的使用场景和影响情况。 若确认需要该功能，请联系销售进行增购。 |
| 61100002 | spider引擎活动的节点数异常 | 原因分析： 工程实际需要的spider分布式节点数，大于注册时购买的「spider分布式节点数」。 解决方案： 超管访问http://IP:端口/webroot/decision/v10/register/info/license，查看注册时的限制值。 若分布式节点数达到限制值，则将无法新增节点，新添加的节点不显示。 若确认需要新增节点，请联系销售进行增购。 |
| 61100003 | 没有数据挖掘lic异常 | 该报错已废弃。 |
| 61100004 | 没有BI图表功能lic异常 | 原因分析： 工程注册时，未购买「BI-图表」功能点。出现该报错说明需要使用该功能。 解决方案： 请先查阅「注册管理」，了解该功能点的使用场景和影响情况。 若确认需要该功能，请联系销售进行增购。 |
| 61100005 | 没有图表功能lic异常 | 原因分析： 工程注册时，未购买「静态图表」功能点。出现该报错说明需要使用该功能。 解决方案： 请先查阅「注册管理」，了解该功能点的使用场景和影响情况。 若确认需要该功能，请联系销售进行增购。 |
| 61100006 | 没有移动端展示lic异常 | 原因分析： 工程注册时，未购买相关功能点。出现该报错说明需要使用该功能。 解决方案： 移动端分为App、HTML5 端、HTML5 集成（微信、钉钉、第三方App集成）访问单张模板/报表目录。 根据使用场景，需要注册不同的功能点，请先查阅「注册管理」，了解使用场景所需的功能点。 若确认需要该功能，请联系销售进行增购。 |
3. 使用错误
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61200401 | 数据库相关问题导致的更新出错 | 原因分析： 这是数据库相关问题导致的更新出错 解决方案： 按照更新出错日志，找到对应的数据表，找到数据表对应的数据连接 按照「数据连接支持范围」找到对应类型的数据连接指导文档，检查数据连接和数据库配置 |
4. 异常信息
4.1 Spider引擎相关
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61300101 | 访问hostname失败 | 原因分析： 访问hostname失败，抛java.net.UnknownHostException异常 解决方案： 配置spider集群的hostname |
| 61300102 | 无法使用端口XXXX | 原因分析： IP 端口配置错误 解决方案： 1）首先确认下当前使用的端口是否被其他工程占用：端口占用查看 2）正确配置 IP 端口：修改FineBI端口号 |
| 61300104 | sprider 多节点文件存储空间不足 | HDFS 空间不足 扩展 HDFS 的存储空间 |
| 61300105 | spider 多节点内存存储空间不足 | Alluxio 空间不足 扩大 Alluxio 的空间配置 |
| 61300106 | spider 多节点内存工作启动异常 | Alluxio Worker 挂了或者满了（可能存在其他原因） 检测 Alluxio 服务 |
| 61300107 | 没有开启 shuffle.service 服务或计算引擎 tmp 空间不足 | 1）没有开启 spark.shuffle.service 服务 2）Spark 的tmp路径空间不足 在 BI 中添加参数或修改 Spark 相应的 tmp 目录配置 |
| 61300108 | spider_calculation_engineblock 写入失败 | Alluxio 的 Worker 挂掉或 temp block id 重复的问题 检查 Alluxio 服务，检查block id |
| 61300109 | sprider 多节点文件数据节点异常 | hdfs datanode 挂了 检查 HDFS 服务 |
| 61300110 | 计算引擎初始化失败 | spark 启动失败 1）spark_driver_host 参数可能配置出错， IP 不对 2）hosts 文件中 localhost 对应了多个 IP（单机版），集群版则可能是本机同一个 hostname 配置了多个 IP 或者 hostanme 与 IP对应错误。 3）Spark 服务异常。检查 spark 的 web 页面状态。（必须要有一个 ALIVE状态的节点） 4）检查其他导致失败因素 |
| 61300111 | BI内存分配不足 | BI 端内存不足 修改 BI 内存 |
| 61300112 | 计算引擎临时文件目录空间不足 | 扩展 Spark 临时文件目录的磁盘空间 |
4.2 功能使用
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61300301 | 文件类型异常 | 更新 Excel 文件类型不一致 检查更新的文件类型 |
| 61300302 | 字段名或表名长度超出key值长度限制，无法保存到配置 | 字段名或表名长度超出 xxx 限制，无法保存 将字段名或表名改短 |
| 61300303 | 报错信息空白 排查报错原因 | |
| 61300304 | xx 业务包，xx 表，xxx 字段名重复 | xx 业务包，xx 表，xxx 字段名重复 修改字段名，使字段名不重复 |
4.3 数据更新
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61300400 | xx 数据库（和 xx 数据库）连接失败，请检查数据连接 | 数据库连接失败 检查数据库连接 |
| 61300401 | 硬盘空间不足 | 硬盘空间不足 硬盘扩容 |
| 61300403 | 打开的文件过多，超过 Linux 系统默认最大打开文件数 | Linux：too many open files 调整 Linux 打开文件个数 |
| 61300404 | xx 表的 xx 字段（xx表的xx字段）为空，无法成功生成关联关系 | 空字段建立关联 检查表间关联关系 |
61300417 | 自助数据集计算超出【单元格】数据量限制，无法成功计算和更新 | 分析用户的自助数据集由于在计算过程或生成过程中超出数据量的限制，不包含中位数和去重记录数的出错情况 产品中有提示文案。主要是通过汇总数据或者添加过滤的方式减少数据来达到完成计算和生成的效果 |
| 61300418 | 中位数或去重记录数计算超出数据量限制，无法成功计算和更新 | 分析用户的自助数据集由于在计算中位数或去重记录数时超出数据量限制 |
| 61300419 | 需要计算的指标数量超出限制，无法成功计算和更新 | 计算过程中参与计算的指标数量太多 减少指标数量 |
| 61300420 | 去重计数/中位数计算超出数据限制量 | 仪表板去重计数/中位数计算超出数据限制量 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）若调整后仍然报错，说明计算量非常大，建议对仪表板增加明细过滤条件，或使用数据处理的自助数据集来进行计算。 |
| 61300421 | 您的自助数据集数据量超过xxx单元格，无法成功更新，请减少需要更新的数据。如减少字段，继续对数据进行过滤，或者对数据进行分组汇总 | 不能因为某个用户不合适的操作导致生成了一个非常大的数据，影响其他用户使用，甚至将磁盘空间占满 减少生成的数据数量 |
| 61300422 | 您的自助数据集数据量超过xxx行，无法成功更新，请减少需要更新的数据。如减少字段，继续对数据进行过滤，或者对数据进行分组汇总 | 减少生成的数据数量 |
| 61300423 | 自助数据集计算超出【行】数据量限制，无法成功计算和更新 | |
| 61300424 | 自助数据集计算超出【内存】数据量限制，无法成功计算和更新 |
4.4 仪表板相关
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
61310001 | 连接失败 | SQL 数据集配置错误-连接失败 packagename 为空 tablename 为空 SQL 语句为空 dataLinkName 为空 异常导致添加失败 |
| 61310002 | 字段缺失 | |
| 61310003 | 字段正在被使用 | |
| 61310004 | 字段重复 | |
| 61310005 | 字段没有权限 | |
| 61310006 | 分组缺失 | |
| 61310007 | 分组正在被使用 | |
| 61310008 | 分组重复 | |
| 61310009 | 分组没有权限 | |
| 61310010 | 业务包缺失 | |
| 61310011 | 业务包正在被使用 | |
| 61310012 | 业务包重复 | |
| 61310013 | 没有业务包权限 | |
| 61310014 | 表缺失 | |
| 61310015 | 表正在使用 | |
| 61310016 | 表重复 | |
| 61310017 | 表没有权限 | |
| 61310018 | 关联缺失 | |
| 61310019 | 关联正在使用 | |
| 61310020 | 关联重复 | |
| 61310021 | 关联没有权限 | |
| 61310022 | 不支持表类型 | |
| 61310023 | 配置层面服务不支持 | |
| 61310024 | 参数异常 | |
| 61310025 | 名字重复 | |
| 61310026 | 不合法路径 | |
| 61310027 | 路径缺失 | |
| 61310028 | 路径操作没有权限 | |
| 61310029 | 对表进行的操作无效 | |
| 61310030 | 路径不可达 | |
| 61310031 | 分析操作不安全 | |
| 61310032 | 模板重复 | |
| 61310032 | 保存异常 | |
| 61310033 | 模板不存在 | |
| 61310033 | 更新异常 | |
| 61310034 | 模板文件夹不存在 | |
| 61310034 | 删除异常 | |
| 61310035 | 查询异常 | |
| 61310036 | 组件类型不支持 | |
| 61310037 | 引擎服务异常 | |
| 61310039 | 排序获取名字错误 | EXCEL 数据集配置错误 字段名和字段顺序不一致 |
| 61310040 | 查询错误 | EXCEL 数据集配置错误 字段个数和类型不一致 |
| 61310041 | 字段类型错误 | EXCEL 数据集配置错误 仅支持格式：xls、csv、xlsx |
| 61310042 | sheet页错误 | EXCEL 数据集配置错误 只读取第一个 sheet 的数据，请确保从第一个单元格开始没有：复杂函数或者 VBA 编程等 |
| 61310043 | sheet表头错误 | EXCEL 数据集配置错误 第一行为字段名，第二行开始为字段的字；请确保第一行没有合并单元格。 |
| 61310044 | 循环依赖报错 | |
| 61310045 | 模板正在编辑 | |
| 61310046 | 模板已挂出 | |
| 61310047 | SQL 语句不正确 | SQL 数据集配置错误-SQL 语句不正确 packagename 为空 tablename 为空 SQL 语句为空 dataLinkName 为空 异常导致添加失败 |
| 61310048 | 未定义的异常信息 | |
| 61310049 | 模板session id已经关闭异常 | |
| 61310050 | 模板命名为空 | |
| 61310051 | 公共链接被关闭 | |
| 61310052 | 分享被关闭 | |
| 61310053 | 模板session找不到 |
4.5 函数相关
| 错误代码 | 错误日志 | 解决方案 |
|---|---|---|
| 61500001 | 公式语法错误 | |
| 61500002 | 非聚合公式存在明细过滤 | |
| 61500003 | 聚合公式和非聚合公式进行运算 | |
| 61500004 | 聚合函数中使用聚合参数 | |
| 61500005 | 聚合函数存在多个指标 | |
| 61500006 | 快速计算函数只有第一个可以是公式 | |
| 61500007 | 快速计算函数内参数没有聚合函数 |
5. 系统提示
| 日志代码 | 提示信息 | 原因&解决方案 |
|---|---|---|
| 62400000 | 功能点获取数据请求正常 | - |
| 62400001 | 获取组件数据时发生错误 | 获取数据错误 SQL语句 “SELECT xxxx” 执行失败，字段信息与添加表时不一致 请检查数据库 若报错 permission_denied ，则可能是数据库权限不足 |
| 62400002 | 获取组件数据时不完整 | 数据缺失 |
| 62400003 | 没有权限获取该组件的数据 | 没有权限 |
| 62400004 | 该组件没有数据 | 没有数据 |
| 62400005 | 数据配置不全 | 数据配置不全 |
| 62400006 | 最大行数不能超过100W，请调整维度字段或联系管理员 | 汇总组件展示数据量超出限制 |
| 62400401 | xx 业务包下的 xx 表生成失败，xx 关联（xxx关联=关联缓存的名字）将使用历史数据生成 | 数据替换逻辑，存在关联的表中某一张表更新失败 检查对应的业务包下的数据表 |
| 62400402 | 因 xx 业务包中的 xx 表实时性被修改，其关联的 xx 业务包中的 xx 分析表的实时状态转换 | 当基础表实时性被修改后，如果出现分析表的状态转换（从抽取状态转换为实时），提示状态变化。 增加前端提示：该表正在被其他分析表使用，如果改变实时性，会导致关联的分析表实时性转换（需要设计） |
| 62400403 | 当前表有修改，需要重新更新数据 | 当前表配置修改，导致抽数的表需要重新更新数据 |
| 62400404 | 来源表有修改，需要重新更新数据 | 来源表配置修改，导致子表抽数的表需要重新更新数据 |
| 62400405 | xx 业务包中 xx 数据表的 xx 字段（和 xx 业务包 xx 数据表的 xx 字段）不符合一对多/多对一/一对一对应关系，无法成功生成关联关系 | 关联关系不一致 检查表间关联关系，重新修改编辑 |
6. 导出报错日志
5.1.13 及之后版本的 BI 工程，当组件预览、数据表更新、数据表预览、数据表编辑时，若出现前端报错，则支持导出相关系统日志和文件。
5.1.15 及之后版本的 BI 工程，新增 SQL表保存、自助数据集保存时，若出现前端报错，则支持导出相关系统日志和文件。
点击报错的「详细信息」，第一行显示「导出日志」按钮，点击「导出日志」即可导出完整报错信息。
解压导出日志压缩包，包含以下内容：
| 文件 | 内容 |
|---|---|
| error.txt | 报错组件的组件配置/表配置/模板配置，方便定位报错的组件，其中：
|
| fanruan.gc.log | 当日零点至导出时的 gc 日志数据 |
| fanruan.log | 当日零点至导出时的 fanruan.log 数据 |
| inspection.xlsx | 环境相关信息 |
