1. 概述
1.1 版本
| Finereport 版本 |
|---|
| 11.0 |
1.2 应用场景
本文将列出在数据准备过程中，常见的问题及排查步骤。
2. 31300013 找不到数据连接
问题描述：
模板预览时，出现报错界面，提示「错误代码：31300013 找不到数据连接」
排查步骤：
选中模板中的数据集，点击「编辑」。若左侧数据连接表界面显示「数据库连接失败」，说明数据连接存在问题。
点击「数据连接」按钮，选择对应数据连接，进行「测试连接」，根据报错修改数据连接相关配置，直到连接成功。
3. 11300001 数据集配置错误
问题描述：
模板预览时，出现报错界面，提示「错误代码：11300001 数据集配置错误」
排查步骤：
选中模板中的数据集，点击「编辑」。点击「数据集预览」按钮，若预览报错，说明SQL语句存在问题。
请根据报错修改SQL语句，直到预览成功。
4. 数据连接数量达到注册lic限制
问题描述：
1）用户新增数据连接时报错「当前数据连接数量已达到注册lic限制(x个)，无法新增」。如下图所示：
2）管理员进入数据连接管理页面时，报错「当前数据连接数量已超过注册lic限制（x个），所有数据连接不可用，请删除多余的数据连接」。如下图所示：
原因分析：
工程注册时，会对数据连接数进行限制。若达到限制值，则会出现报错或异常状态。
超级管理员登录数据决策系统，在当前页下访问http://IP:端口/webroot/decision/v10/register/info/license，即可查看注册时的限制值。
若数据连接数达到限制值，则将无法添加数据连接，新添加的数据连接不显示。
解决方案：
1）删除系统中已有的无用的数据连接，即可新增数据连接。
2）联系帆软销售增购数据连接数量。
5. 数据连接异常消失
问题描述：
1）数据连接异常消失：如重启消失，注册后消失，突然消失等。
2）新建/更新数据连接后，保存异常，保存不上等。
5.1 检查是否达到注册限制
原因分析：
工程注册时，会对数据连接数进行限制。若达到限制值，则可能会导致系统中超限的数据连接消失。
排查步骤：
超级管理员登录数据决策系统，在当前页下访问http://IP:端口/webroot/decision/v10/register/info/license，即可查看注册时的限制值。
若数据连接数达到限制值，则将无法添加数据连接，新添加的数据连接不显示。
解决方案：
1）删除系统中已有的无用的数据连接，即可新增数据连接。
2）联系帆软销售增购数据连接数量。
5.2 检查外接数据库是否共用
原因分析：
多个工程共用同一个外接数据库时，可能会导致A工程中的配置被B工程覆盖，从而引起数据连接异常消失的情况。
排查步骤：
检查是否存在其他工程使用同一个外接数据库。
解决方案：
若确实共用，请先将当前外接数据库备份。
将其中一个工程的外接数据库进行迁移，详情请参见：配置外接数据库
5.3 检查远程连接环境是否一致
原因分析：
一些特殊类型的数据集/数据连接，需要依赖插件实现。
远程设计环境下，必须确保本地设计器和远程工程都安装了相关插件，才可以使用该数据集/数据连接。
排查步骤：
检查是否为远程设计环境，是否为依赖插件的数据连接类型，是否设计器和工程均安装了插件。
解决方案：
请在设计器安装与工程同版本插件后，再进行远程设计。
6. 填报报错 SQL error or missing database
问题描述：
填报提交时，弹窗报错「[SQLITE_ERROR] SQL error or missing database (unrecognized token: "XXXX")」
即：发生SQL 错误或丢失数据库（不可识别的字符：xxxx）
原因分析：
若确认SQL语句写的无误，那么造成填报失败的原因可能是，数据库表字段命名违反了数据库的相关限制条件。
解决方案：
请检查并修改数据库表字段命名。
在创建数据库和表及字段时，请务必严格按照对应数据库指定的命名规则进行命名，否则可能会造成严重的后果。
本文将为大家列出一些常见的命名规则。
| 内容 | 命名规范 |
|---|---|
| 数据库表 | 1）表名前应该加上前缀，前缀全部大写或首字母大写，表名中包含的单词首字母大写 2）数据库表名应该有意义，易于理解，最好使用英文单词或缩写 3）表名不易太长，最好不要超过 3 个英文单词长度 4）在数据库表命名时应该用英文单词的单数形式。如员工表：Employee 5）如果是后台表命名时应该在表名基础上加上后缀 6）在表创建完成前，应该为表添加表的注释 7）不建议使用数据库关键字。如：name，time，datetime，password 等 8）不建议以数字开头。如2009年，105车场 |
| 表字段 | 1）数据库表字段应该是有意义，易于理解，最好是能够表达字段含义的英文字母 2）系统中所有属于内码，即仅用于标识唯一性字段，建议取为 ID，采用类型为整型或长整型 3）系统中属于是业务内的编号字段，建议字段命名为 code 4）不要在数据库表字段中包含数据类型，如：datetime、int 等 5）不要在数据库表字段命名时重复表名，可以使用表名首字母。如：tab_xx 6）不建议使用数据库关键字。如：name，time，datetime，password 等 7）不建议以数字开头。 如2009年，105车场 |
7. 未加载到驱动
问题描述：
新建数据连接时，点击「测试连接」，报错「未加载到驱动」，如下图所示：
原因分析：
工程中不存在该数据连接所使用的驱动器。
解决方案：
对于外网用户，可直接通过提示界面中的超链，跳转到对应驱动下载的帮助文档。
对于内网用户，请根据您的数据库和驱动类型，自行选择对应文档，下载并放置驱动：JDBC数据连接
驱动安装完毕后，重新尝试连接即可。
8. NoClassFoundException
问题描述：
工程日志中存在报错信息「NoClassFoundException」
排查思路：
工程中不存在该数据连接所使用的驱动器，或者驱动有问题
9. NoClassDefFoundError
问题描述：
工程日志中存在报错信息「NoClassDefFoundError」
排查思路：
工程下可能存在冲突的驱动包。
