错误代码汇总及解决方案

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 接口的加密锁。出现此提示时，请检查加密锁有没有插好，加密锁驱动有没有正常加载。

详情请参见：加密锁认证

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

并发数指的是允许同时访问报表服务器的 IP 个数

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）使用文件服务器时开启集群，文件服务器连不上

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

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

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 远程设计用户名密码错误