错误代码汇总及解决方案

1：报表

2：平台

3：数据连接

6：BI

7：FVS

1：报错日志

2：提示日志

1：不支持的功能

2：使用错误

3：异常信息

4：系统提示

前 3 位相当于划分错误类别，后面这几位才是将每个错误进行编码

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

行式引擎只支持单个数据集。若数据来自不同的地方，可以在定义数据集时自行将需要的数据整合到一个数据集中使用

请您检查报表中是否使用了条件属性改变行高或列宽，如下图所示：

若有请您删除对应的条件属性设置或关闭行式引擎

请您检查报表中是否对数据进行了形态设置，如下图所示：

若有请您取消形态设置或关闭行式引擎

请您检查报表中是否对数据进行了其它扩展属性设置，如下图所示：

行式引擎不支持无扩展和从左到右扩展属性，可以修改报表，使报表中只有从上到下的扩展属性，也可以取消使用行式引擎功能

请您检查报表中是否插入了悬浮元素，例如悬浮图表等。若有请您删除悬浮元素或关闭行式引擎。如下图所示：

请您检查报表中是否开启了报表分栏，如下图所示：

若有请您关闭分栏或关闭行式引擎

请您检查报表中是否使用了除纯色外的单元格背景，如下图所示：

 若有请修改单元格背景

请您检查报表中的页眉页脚是否为图片和文字的组合，如下图所示：

若需要导出 word 后的文字可编辑，需要定义页眉时只用纯文本

1）请您检查报表中的图片，并调整图片

2）调整模板导出属性中的分辨率

FVS 可视化看板中使用了未注册的组件

1）确认是否已购买对应组件功能，功能点的说明和未购买影响请参见：注册管理 第四章

2）若注册信息中显示该功能可用，但实际使用时仍然报没有功能，可能您获得的 lic 版本与报表版本不一致，此时需要联系商务人员进行核实

您的 FineReport 工程使用了加密锁认证，服务器上需要一直插着 USB 接口的加密锁。出现此提示时，请检查加密锁有没有插好，加密锁驱动有没有正常加载。

详情请参见：加密锁认证

请检查当前工程目录WEB-INF\resources文件夹下有没有 FanRuan.lic 文件，若没有请放置，具体步骤请参考：注册常见问题处理方案

1）请检查模板中数据连接配置能否连接成功。请参考：通用数据连接常见问题

2）检查模板中是否使用了动态参数，请参考：超级链接常见问题

需要在 jvm 环境配置的地方，加上相应的位置即可。

例如：tomcat JVM_OPTS = "$JVM_OPTS;-Dxxx=绝对路径"

模板内容区域中存在单元格左父格关系不连续，请您根据提示的单元格检查左父格的关系，如下图所示：

标记导入的数据区域存在没有设置为列表的数据行，请您检查标记区域的扩展设置，如下图所示：

检查是否存在单元格中仅有等号而等号后没有任何内容

对单元格进行公式内容填写，或调整单元格元素为普通文本

1）数据量过大，请参考：大数据量模板排查思路 

2）笛卡尔积，请参考：防止填报笛卡尔积 

3）SQL 执行时间过长，请参考：模板限制 

4）单元格超过限制，请参考：模板限制 

请确认当前使用的资源是否被删除或移动。可通过「服务器>fvs资源中心」，点击刷新资源，重新上传或选择其他资源

错误说明：配置文件服务器的情况下，设计器中编辑复用资源，文件服务器的读写是异步的。如果有复用资源文件到文件服务器的任务没有执行完，此时点击刷新资源，会抛错给前台，是正常现象

解决方案：等待几分钟重新刷新即可

1）请参考 监控视频无法播放排查步骤 进行排查

2）若排查后问题仍然存在，请您联系官方的技术支持

1）使用浏览器的开发者工具查看是否存在控制台错误信息，按照错误提示检查

2）检查组件是否与当前使用的插件版本兼容，可更新插件至最新版本查看问题是否存在

3）若问题仍然存在，请您联系官方的技术支持

并发数原理相关介绍请参见：报表并发数的原理 

1） FineReport 工程未注册或者注册许可已经过期

原因分析：未注册工程的并发数固定为 2 ，即同时只能有 2 个不同的 IP 访问服务器。若超过2个并发，则会出现此提示。

解决方法：您可联系销售进行正式注册，或等待其他IP退出后进行访问。

未注册的影响请参见：注册简介

2）FineReport 工程已注册

原因分析：说明当前系统访问的IP个数已超过最大并发数限制。

解决方法：您可联系销售增加最大并发数，或等待其他IP退出后进行访问。

您未购买该功能需要的功能点，请联系销售增购此功能点。

功能点的说明和未购买影响请参见：注册管理 第四章

前台请求的认证token超时，默认有效时间为一小时，可以在系统管理中配登录超时时间

详情请参见：登录超时

平台文件数据集的默认最大文件限制为20M，上传的文件超过此大小时会出现报错。

用户可F12，在浏览器控制台查看具体限制信息，关键词为「文件过大，上限为XXX」

出现该异常的场景有：

1）数据连接重命名，不允许和其他数据连接重名

2）编辑目录，不允许和其他目录重名

3）用户、部门、角色重命名，不允许相同命名

添加行权限的时候，发现该表下对目标角色已经存在对应的行权限了

查询表 fine_pack_filter 排查

1）「管理系统>用户管理」中存在该用户，但是用户被禁用

若该用户被禁用时在线，则会被立刻踢出，同时抛出该异常

若该用户被禁用时不在线，登录时会提示「用户名不可用」

解决方法：联系系统管理员，解除禁用

2）「管理系统>用户管理>平台使用用户」开启限制，但该用户不在「PC端使用用户」中

解决方法：联系系统管理员，将该用户添加到「管理系统>用户管理>平台使用用户>PC端使用用户」中

3）管理员在对系统进行注册时，会踢出当前正登录用户，并抛出该异常

解决方法：等待管理员注册结束即可正常登录

此场景报错故意模糊化，防止出现安全问题

可能出现的场景：

1）输入的用户名不存在

2）输入的用户密码不正确

3）用户校验失败

4）角色权限认证失败

5）自定义登录接口调用失败

6）finedb没有加载到该用户

导入树数据集前请清空原有数据

注：该异常已弃用，目前导入树数据集不会清空原有用户。

导入用户时切换了加密方式，会返回该异常。

前台会根据此异常，弹出清空用户的警告。

在两种情况下会出现此异常：

1）根据验证码重置密码时，新密码与旧密码相同，需要重新填写

2）根据旧密码修改密码时，新密码与旧密码相同，需要重新填写

请输入与旧密码不相同的新密码

管理员修改了 用户身份验证 方式，已登录的用户会被踢出系统

此时会抛出该异常，无需处理，待管理员修改完成后，用户即可重新登录

在「同步用户」管理时，管理员若关闭同步用户，或切换同步用户数据集，之前的同步用户会被踢出登录

「管理系统>用户管理>平台使用用户」开启了限制，但该用户不在「移动端使用用户」中

解决方法：联系系统管理员，将该用户添加到「管理系统>用户管理>平台使用用户>移动端使用用户」中

自定义角色名称长度超出最大限制（最大为200）

减少自定义角色名称字符长度

同步来源数据下不可以存在手动来源的数据
添加用户、添加部门等情况会检测数据源，需要删除掉手动来源的数据

同步用户高度依赖数据源，若数据源出现问题，例如被恶意清空数据库表，会导致同步到系统中的用户被清空，操作无法逆转。

因此 FineReport 提供同步熔断策略。10.0.18 及之后版本的报表工程，新增「异常数据中断同步」按钮。

管理员开启「异常数据中断同步」后，可设置用户数量减少达到X%，停止同步。X为1-100的正整数。

例如系统中原有100个同步用户（不包含手动添加/导入的用户数），设置为30%，即同步减少30（100*30%）个用户及以上，就会停止本次同步。

详情请参见：同步用户 5.4 节

保存同步用户配置时，cron表达式非法。

填写正确的cron表达式

1）管理目录不能拖动到首页

2）首页不能拖动到管理目录

3）目标位置不可以和本身冲突

访问目录时报错，您选择的目录节点不存在，请重新选择

原因分析：传入后台的entryId在数据库中无法找到导致

解决方案：查看请求目录的请求，/entry/access/{entryId}中的路径参数entryId在数据库中fine_authority_objcet中无法找到

主要是token失效和解析登录token失败的场景

检查token的正确性和是否过期

后台做非法字符检测，思路是将合法格式列出来，如果对应内容不属于合法的格式，就抛出异常

这个校验是后台校验，前台无法获取到哪些是合法字符

请删除特殊字符，正确输入格式

获取用户上一次的登录信息失败，说明当前用户是第一次登录，无上次访问记录

管理员可在 finedb 的 fine_last_login 中的 userid 字段查看下，确认是否有该用户

部分用户在未登录的情况下，没有自动进行重新登录，从而导致FR的token缺失，产生报错

finedb里面设置字段ServerConfig.tokenFromCookie为true

设置方法请参考：FINE_CONF_ENTITY可视化配置

设置模板认证配置项，如果屏蔽了数字签名功能，但是传过来的认证方式还是数字签名认证抛出的错误

修改 TemplateAuthConfig.digitalAuthAvailable 值为 true，开启数字签名功能

开启集群时平台数据库未迁移产生的报错

开启集群配置前先迁移到外置数据库，请参考：配置外接数据库

开启集群或设置状态服务器时状态服务器连不上报的错

检测状态服务器信息是否正确，服务是否启动，确保状态服务器连接成功

有以下四种情况：

1）使用文件服务器时开启集群，文件服务器连不上

3）刷新文件服务器缓存时文件服务器连不上

检查文件服务器配置信息，确保文件服务器连接成功

BI工程设置Spider的时候抛出的错

spider集群服务没有起起来

成功切换状态服务器时，需重新登录，这是一个提示，重启服务即可

正在备份的时候，又触发了一次备份

请等待当前备份结束

设计器启动的平台，不支持升级  JAR 包，请用设计器内的更新升级功能进行升级

详情请参见：小版本升级指南 2.1节

数据连接id在数据库中不存在

属于产品逻辑，不用在意；一般是脏数据，删掉就行

错误代码:21300103 数据连接数量超出lic限制

说明后台收到的资源文件损坏，请检查资源文件zip包中的entity.json中是否有数据

若无，说明上传的文件有问题

若有，请尝试更换浏览器

请联系帆软技术支持并提交产品bug

资源导入时，导入的资源需要的工程版本和当前工程版本不匹配

请确保工程版本一致

错误代码:21300103 验证码超时

横向间距小于100或纵向间距小于50

系统管理>常规配置>常规参数配置websocket ssl时路径或密码错误，检测ssl的密钥路径和密码是否正确

系统管理>常规配置>加密算法，切换前后相同的加密方法，请更换加密方法

1、ssoToken解析失败

系统管理>集成后台单点登录，解密测试测试当前ssoToken是否正确；若解密失败查看帮助文档重新生成ssotoken即可

2、登录超时，请重新登录

系统管理>集成后台单点登录，查看帮助文档重新生成ssoToken

1、当前地址无法访问，请确保证书有效或者手动将证书导入到 JDK 证书信任库

将CAS服务器的SSL证书导入帆软服务器的JDK证书信任库

2、当前地址无法访问，请输入与证书匹配的host

SSL证书中的地址与当前地址不匹配，请检查

3、请携带用户名密码参数: 形如/cas/reset?username=xxx&password=xxx

CAS单点配置重置接口（/cas/reset）需要携带用户信息，请添加username和password参数

4、仅超管可以操作

CAS单点配置重置接口（/cas/reset）只支持超管

错误代码：22400001 用户名不能为空

错误代码：22400012 手机未与该账号绑定

密码强度限制

请检查当前 Web 应用是否被多个服务器同时使用

1.KILL -9 清理进程，删除db.lck然后重启

2.在 /conf/context.xml 的 </Context>前添加以下内容（大小默认是1024，单位是KB）：
<Resources cachingAllowed="true" cacheMaxSize="100000" />
重启刷新下

错误代码：11300111 当前密码已失效

开启集群配置前先迁移到外置数据库，方法参照文档：

配置外接数据库

可能的原因：

• 使用文件服务器时开启集群，文件服务器连不上

• 设置、测试文件服务器时文件服务器连不上

• 刷新文件服务器缓存时文件服务器连不上

需要检查文件服务器配置信息，确保文件服务器连接成功

错误代码：11300105 远程设计用户名密码错误