历史版本20 :设计器启动常见问题 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

用户在使用中会遇到设计器启动失败的场景,但是不知道如何定位问题或者解决问题,本文根据常见的启动类客户 bug 原因及解决方案,整理出了常规的排查步骤,用户也可根据具体出现的情况查询解决方案:

1)确认环境:确认安装过程正常,包括以下几点

  • 安装的设计器支持系统是否和电脑操作系统匹配

  • 安装后 jar 包的存放路径是否正常,是否进行过 jar 包移动

  • 远程环境和本地环境的jar包是否一致

  • 是否是外置数据库,假如是外置数据库,确认数据库连接信息是否正常

  • 是否在远程设计器中,假如远程设计器,确认远程环境是否正常,包括远程环境中的数据库信息

  • mac 系统设计器无法启动问题,确认是否是问题版本 :12.28 的 jar 包适配 10.13 版本的 mac 会有问题,需使用最新版的 mac 设计器

2)确认权限:确认启动设计器的用户,需要有对文件读写权限。

3)看日志:根据设计器闪退时间,找到日志中对应时间进行日志分析,一般需要开启 debug 模式

通过 bat 方式启动设计器,根据 bat 启动后命令行中的报错定位问题,假如命令行闪退,可以在 designer.bat 文件后面加 pause,然后查看命令行中的报错,根据具体报错进行问题解决

4)杀进程:将设计器在任务管理器中杀掉或者在命令行中通过进程 id 将进程杀掉,然后重启设计器,看能否启动成功

5)清缓存:将设计器关闭后确认进程已经关闭,清除设计器的缓存文件,删除 C 盘的用户下的 FineReport100 文件

6)修改设计器内存:将设计器内存进行修改

7)重装设计器

8)重装系统

2. 安装 FineReport 提示有风险编辑

2.1 问题描述

在 windows8 或 windows10 系统下,安装 FineReport 软件可能会提示有风险,阻止安装该软件,如下图所示:
1574663580223994.png

2.2 原因分析

SmartScreen 筛选器是 Internet Explorer 中的一种帮助检测仿冒网站的功能,SmartScreen 筛选器还可以帮助阻止安装恶意软件。

安装 FineReport 出现上面这个提示是因为系统将其误认为是恶意软件或者破解软件,所以只需要关掉 SmartScreen 筛选器即可。

2.3 解决方法

打开Windows 设置>更新和安全>Windows 安全中心,打开Windows 安全中心。如下图所示:

2020-05-25_13-41-50.png

打开应用和浏览器控制>检查应用和文件,勾选关闭即可。如下图所示:

1.png

3. 设计器闪退编辑

设计器启动时闪退,常见的情景、原因及解决方案如下表:

问题描述原因分析解决方法
设计器启动,加载至页面后闪退,打开fanruan.log 日志文件,报错如下:2019-03-12T15:06:50.153+0800 WARN Could not find matching type descriptor for requested Java class [java.util.List]; using fallback
2019-03-12T15:06:50.159+0800 WARN Could not find matching type descriptor for requested Java class [com.fr.swift.source.alloter.AllotRule]; using fallback
配置文件中的全局样式有问题检查设计器的配置目录,将 finedb 替换成为一个可以正常启动的工程中的 finedb
设计器启动,加载至页面后闪退,没有报错日志电脑系统存在问题重新安装电脑系统
设计器启动闪退,error.log中只打印了闪退,没有打印其他报错信息设计器安装过程中存在异常
重装设计器,并对服务器的jar包进行升级后,即可应用正常
设计器启动一直闪退查看日志发现引用了非安装磁盘下的工程可能是工作目录的问题找到C盘 xml 文件 保存激活码后删除 xml 文件,重启设计器
设计器闪退, 修改内存到4G也出现闪退设计器安装错误确认电脑系统版本号和安装设计器支持系统版本号,重新安装
finereport10.0闪退,日志无明显的报错,有内部崩溃文件hs开头电脑兼容问题

重启电脑、重装设计器

4. 设计器无法启动编辑

设计器无法启动的相关问题,常见的情景、原因及解决方案如下表:

问题描述原因分析
解决方法
设计器全新安装,无法启动,打开 fanruan.log 日志文件,报错如下:

17:54:56 Thread-16 ERROR [standard] C:\FineReport_10.0\webapps\webroot\WEB-INF\assist\phantomjs\lib\vancharts-all.js (拒绝访问。)

java.io.FileNotFoundException: C:\FineReport_10.0\webapps\webroot\WEB-INF\assist\phantomjs\lib\vancharts-all.js (拒绝访问。)

非管理员用户(非 Administrator 用户)安装设计器,且设计器安装到了系统盘(C盘),设计器启动时,文件没有读写权限

1)设计器安装到非系统盘(除了C盘外别的盘)

2)若安装到了系统盘,那么需要给文件夹赋予全部用户的读写权限,设置方法

3)用管理员用户(Administrator 用户)安装,管理员用户(Administrator用户)启动

设计器安装后无法启动

可能原因如下:

1)缓存/内存问题

2)启动的时候连接了远程设计平台,远程设计平台配置了外接库,外接库的root账号密码失效

3)jar 包放置位置错误、缺少多个 jar 包、 jar 包不匹配

解决方法如下:

1)关闭进程,删除c盘缓存文件,重启设计器;或清除缓存,用大内存启动

2)重新登录数据库密码,重启服务器

3)查看环境,确认 jar 包放置情况及 jar 包是否缺失,并确认 jar 包是否匹配,进行替换或增补即可

设计器 exe 启动无响应,任务管理器中无设计器线程,bin下生成error.log,但error.log是空的,bat启动设计器正常系统中存在加密软件将设计器添加到加密软件的白名单中即可
设计器无法启动,bat启动到一定程度闪退,查看错误日志,关键报错:
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
-
任务管理器里面搜索设计器进程,删除后重启设计器
jar 包替换后,设计器无法启动了-
重装设计器
开机后首次启动设计器卡在启动页面很长时间,然后报错-出现意外错误,关掉后重启正常-
备份工程,重装设计器
10.0设计器打开的时候停在启动动画-清除缓存后重启设计器

设计器无法启动

报错:OpenJDK 64-Bit Server VM warning: ignoring option MaxPermSize=128m; support was removed in 8.0

-重装设计器

5. 设计器无限重启(restart)编辑

5.1 问题描述

更新完设计器插件后点击立即重启,然后设计器就一直在调用 restart.exe,完全没办法正常启动。

例如:设计器升级更新后没有点击立即重启,点了稍后重启,然后又更换了语言,弹出立即重启,然后设计器就崩溃了,一直在无线调用 restart.exe,设计器完全没办法启动。

5.2 解决方法

一直调用 restart 的情况下,删掉设计器的 webroot 同级目录下 delete.properties 和 restart.lock 文件就好了。

注:在删除文件之前需要先停掉无限启动的 restart 进程。

       方法1:重启电脑。

       方法2:修改掉设计器 bin 目录下的 restarte.exe 的名字,然后任务管理器挂掉已经存在的 restart.exe 的进程

6. The JVM could not be started编辑

6.1 问题描述

启动设计器时,弹出错误提示框,无法正常启动,错误信息如下:

The JVM could not be started. The maximum heap size (-XMx) might be too large or anti virus or firewall tool could block the execution

6.2 解决方法

打开%FR_HOME%\bin\designer.vmoptions文件,将 -Xmx 的值改小一点,修改后重启设计器即可。如下图所示:

1574665951480263.png

7. 设计器页面错乱编辑

7.1 问题描述

当使用设计器远程服务器进行报表设计的时候,有时候会出现设计器卡死问题。

当我们再次登录设计器时候,发现设计器显示页面错乱,有时会有英文产生。

7.2 解决方法

当出现这个问题时候,只需要进行 Ctrl + N 新建一个报表,同时将远程服务器的 目录切换 为本地默认目录,重新启动一下设计器即可解决问题。

8. 泰文乱码编辑

8.1 问题描述

在设计器单元格内或者公式编辑框内编辑泰文时会乱码,如下图所示:

  • 单元格:

1.png

  • 公式编辑框:

2.png

8.2 原因分析

设计器 OpenJDK 不支持显示泰文。

8.3 解决思路

将 JDK 安装目录下的%JAVA_HOME%\jre文件夹拷贝,覆盖掉设计器安装目录下的%FR_HOME%\jre文件夹。

将 JDK 安装目录下的%JAVA_HOME%\jdk\lib目录下的tools.jar拷贝,复制到设计器安装目录%FR_HOME%\lib文件夹中。

注1:如果不引入 tools.jar ,设计器无法正常启动。

注2:10.0 设计器要求 JDK 版本为:JDK 1.8 且小版本需在 JDK8u102 以上。

1574667561794601.png

9. 打开设计器一直停在加载页面编辑

9.1 问题描述

打开设计器后长时间停留在加载动画页面,无法进入设计器主页面。

9.2 原因分析

报错提示 Java 内存溢出,只是由于设计器内存分配不够导致的。

9.3 解决方案

编辑器打开%FR_HOME%\bin\designer.vmoptions,将设计器内存调大一些,修改设计器内存的方法参见文档:报表设计器内存修改