目录:
1. 概述编辑
本文列举 配置外接数据库 时,可能出现的报错和解决方案。
2. 数据库迁移后升级 JAR,无法打开平台编辑
问题描述:
用户已配置外接数据库,升级 JAR 后,无法打开平台,报错:TASKNAMECALCCULATEATEONCE 标识符和 USERALIAS 标识符无效
原因分析:
进行迁移用户没有 alter 权限,无法生成字段。
解决方案:
给迁移的用户授权 alter 权限。
3. 用户 root 登录失败 ClientConnectionId:XXX编辑
问题现象:
配置外接数据库时,出现报错:用户 root 登录失败,ClientConnectionId:e484a26e-8f2b-4e28-b9e4-32798ec032b7 ,以及外置数据无法连接配置等报错
原因分析:
报错是由于 FineReport 外接数据库的配置错误,需要删除 FineReport 的外接数据库的配置信息,重新配置外接数据库。
解决方案:
删除FineReport_10.0/webapps/webroot/WEB-INF/config下的后缀名为 db.properties 文件,重新对 FineReport 外置数据库进行配置。
4. 迁移数据库后,回退JAR包平台登录失败编辑
问题描述:
报表工程已迁移至外接数据库,升级 JAR 后,又迁移至另一外接数据库,回退 JAR,发现平台登录失败,显示数据库连接异常,如下图所示:
原因分析:
JAR 回退,但存储外接数据库配置的 db.properties 文件没有跟随其变化。
解决方案:
检查 %FR_HOME%/webapps/webroot/WEB-INF/config 路径下 db.properties 文件,手动修改相关配置。
举例:一工程迁移到 MySQL8 数据库,升级 JAR 后 重新迁移到 MySQL5.7.28 数据库,回退工程,启动失败,前台显示连接不上数据库,将db. properties中方言的 8 改为 5 即可。
修改前:
hibernate.dialect=com.fr.third.org.hibernate.dialect.MySQL8Dialect
修改后:
hibernate.dialect=com.fr.third.org.hibernate.dialect.MySQL5Dialect
5. 集群环境下 FineDB 迁移失败编辑
问题描述:
集群环境下迁移 FineDB 数据库,使用平台功能迁移,出现如下图所示的界面后,点击登录会反复刷新此界面。
原因分析:
集群环境下的迁移操作方法出错。
解决方案:
集群迁移需要把其他节点关闭,只启动一个节点进行迁移。
迁移成功后,把 db.properties 文件复制到没迁移的节点,然后关闭集群所有节点再启动。
6. CAS单点环境下 FineDB 迁移失败编辑
问题现象:
1)迁移外接数据库时一直卡在数据导入阶段。
2)后台存在报错:database is locked。
3)工程做了 CAS 单点,报错里有 CAS 相关的日志。
原因分析:
迁移时有其他用户访问了平台,导致部分表被锁死,无法迁移。
解决方案:
先将 CAS 单点撤掉,保证没有用户访问平台。
外接数据库迁移成功之后,再将 CAS 单点加上。
7. 定时调度任务导致迁移失败编辑
问题现象:
迁移外接数据库失败,报错:
Null value was assigned to a property [class com.fr.scheduler.quartz.entity.QuartzFiredTriggers.isNonconcurrent] of primitive type setter of com.fr.scheduler.quartz.entity.QuartzFiredTriggers.isNonconcurrent
原因分析:
定时调度执行过程中,FineDB 中的 QRTZ_FIRED_TRIGGERS 表会临时记录定时调度数据,任务执行成功后,数据自动删除。
当定时调度任务执行了一半,数据已生成时,进行外接数据库迁移操作,暂停定时调度任务失败,导致迁移失败。
解决方案:
按照报错信息,清空相关表,例如清空 QRTZ_FIRED_TRIGGERS 表数据。
8. MySQL The table 'fine_conf_entity' is full编辑
问题现象:
配置 MySQL 数据库,导入数据的时候报错:java.lang.Exception: migrate table com.fr.config.entity.Entity failed
查看%FineReport%/logs/fanruan.log,报错:The table 'fine_conf_entity' is full,如下图所示:
解决方案:
进入 MySQL 的配置文件/etc/my.cnf,在[mysqld]下添加/修改两行:
tmp_table_size = 256M
max_heap_table_size = 256M
系统默认是 16M ,修改完后重启 MySQL 。
9. 数据库连接失败 wait millis 10000,active0,maxActive 50编辑
问题现象:
配置 SQL Server 和 Oracle等含有「模式」的数据库时,出现报错:数据库连接失败,wait millis 10000,active0,maxActive 50
如下图所示:
排查思路:
1)确认数据库名称,主机地址,端口用户名和密码是否正确。
2)确认此服务器此端口是否开放给其他电脑,可在其他地方进行数据库连接测试。
3)更改模式,使其与数据库用户名一样,如下图所示:
10. Oracle19c 数据迁移卡住编辑
问题现象:
Oracle19c数据库,数据连接成功,但是在配置外接数据库时一直卡在正在连接状态。
原因分析:
用户环境禁用了 PUT、DELETE请求,导致平台一些请求不正常。
解决方案:
用户可通过安装「PUT、DELETE请求转成POST」插件,将 PUT、DELETE 请求转成 POST 请求。
详情请参见:PUT、DELETE请求转成POST插件