反馈已提交

网络繁忙

您正在浏览的是 FineBI6.0 帮助文档,点击跳转至: FineBI5.1帮助文档

错误代码汇总

  • 文档创建者:doreen0813
  • 历史版本:35
  • 最近更新:Carly 于 2022-12-14
  • 1. 概述

    1.1 版本

    FineBI服务器版本  功能变更
    6.0-

    1.2 应用场景

    本文提供 FineBI 常见的错误代码汇总,方便您快速定位到错误并找到解决方案。

    1.3 代码说明

    在使用 FineBI 的过程中会遇见各种各样的错误,此时,可以查看 FineBI 的系统日志%FineBI%/logs/fanruan.log寻找报错原因,解决问题。

    错误代码以 8 位数字代码标记,如下图所示:

    1583994792999877.png

    报错代码每一位代表的含义如下:

    代码位数数字含义说明
    第 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-分布式引擎」功能点。出现该报错说明需要使用该功能。

    解决方案:

    请先查阅「注册管理」,了解该功能点的使用场景和影响情况。

    若确认需要该功能,请联系销售进行增购。

    61100002spider引擎活动的节点数异常

    原因分析:

    工程实际需要的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 端口配置错误

    解决方案:

    修改被占用的端口:修改FineBI工程端口号

    61300104sprider 多节点文件存储空间不足

    HDFS 空间不足

    扩展 HDFS 的存储空间

    61300105spider 多节点内存存储空间不足

    Alluxio 空间不足

    扩大 Alluxio 的空间配置

    61300106spider 多节点内存工作启动异常

    Alluxio Worker 挂了或者满了(可能存在其他原因)

    检测 Alluxio 服务

    61300107没有开启 shuffle.service 服务或计算引擎 tmp 空间不足

    1)没有开启 spark.shuffle.service 服务

    2)Spark 的tmp路径空间不足

    在 BI 中添加参数或修改 Spark 相应的 tmp 目录配置

    61300108spider_calculation_engineblock 写入失败

    Alluxio 的 Worker 挂掉或 temp block id 重复的问题

    检查 Alluxio 服务,检查block id

    61300109sprider 多节点文件数据节点异常

    hdfs datanode 挂了

    检查 HDFS 服务

    61300110计算引擎初始化失败

    spark 启动失败 

    1)spark_driver_host 参数可能配置出错, IP 不对

    2)hosts 文件中 localhost 对应了多个 IP(单机版),集群版则可能是本机同一个 hostname 配置了多个 IP 或者 hostanme 与 IP对应错误。

    3)Spark 服务异常。检查 spark 的 web 页面状态。(必须要有一个 ALIVE状态的节点)

    4)检查其他导致失败因素

    61300111BI内存分配不足

    BI 端内存不足

    修改 BI 内存

    61300112计算引擎临时文件目录空间不足扩展 Spark 临时文件目录的磁盘空间

    4.2 功能使用

    错误代码
    错误日志解决方案
    61300301文件类型异常

    更新 Excel 文件类型不一致

    检查更新的文件类型

    61300302字段名或表名长度超出key值长度限制,无法保存到配置

    字段名或表名长度超出 xxx 限制,无法保存

    将字段名或表名改短

    61300303

    报错信息空白

    排查报错原因

    61300304xx 业务包,xx 表,xxx 字段名重复

    xx 业务包,xx 表,xxx 字段名重复

    修改字段名,使字段名不重复

    4.3 数据更新

    错误代码错误日志解决方案
    61300400xx 数据库(和 xx 数据库)连接失败,请检查数据连接

    数据库连接失败

    检查数据库连接

    61300401硬盘空间不足

    硬盘空间不足

    硬盘扩容

    61300403打开的文件过多,超过 Linux 系统默认最大打开文件数

    Linux:too many open files

    调整 Linux 打开文件个数

    61300404xx 表的 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模板已挂出
    61310047SQL 语句不正确

    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” 执行失败,字段信息与添加表时不一致

    请检查数据库

    62400002获取组件数据时不完整数据缺失
    62400003没有权限获取该组件的数据没有权限
    62400004该组件没有数据没有数据
    62400005数据配置不全数据配置不全
    62400006最大行数不能超过100W,请调整维度字段或联系管理员汇总组件展示数据量超出限制
    62400401xx 业务包下的 xx 表生成失败,xx 关联(xxx关联=关联缓存的名字)将使用历史数据生成

    数据替换逻辑,存在关联的表中某一张表更新失败

    检查对应的业务包下的数据表

    62400402因 xx 业务包中的 xx 表实时性被修改,其关联的 xx 业务包中的 xx 分析表的实时状态转换

    当基础表实时性被修改后,如果出现分析表的状态转换(从抽取状态转换为实时),提示状态变化。

    增加前端提示:该表正在被其他分析表使用,如果改变实时性,会导致关联的分析表实时性转换(需要设计)

    62400403当前表有修改,需要重新更新数据

    当前表配置修改,导致抽数的表需要重新更新数据

    62400404来源表有修改,需要重新更新数据

    来源表配置修改,导致子表抽数的表需要重新更新数据

    62400405xx 业务包中 xx 数据表的 xx 字段(和 xx 业务包 xx 数据表的 xx 字段)不符合一对多/多对一/一对一对应关系,无法成功生成关联关系

    关联关系不一致

    检查表间关联关系,重新修改编辑

    6. 导出报错日志

    当组件预览、数据表更新、数据表预览、数据表编辑、新增 SQL表保存、自助数据集保存时,若出现前端报错,则支持导出相关系统日志和文件。

    点击报错的「详细信息」,第一行显示「导出日志」按钮,点击「导出日志」即可导出完整报错信息。

    解压导出日志压缩包,包含以下内容:

    文件
    内容
    error.txt

    报错组件的组件配置/表配置/模板配置,方便定位报错的组件,其中:

    • target:表名/组件id

    • comment:表转义名/ 组件名

    fanruan.gc.log当日零点至导出时的 gc 日志数据
    fanruan.log当日零点至导出时的 fanruan.log 数据
    inspection.xlsx环境相关信息

    附件列表


    主题: 管理系统
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持