反馈已提交

网络繁忙

设计器启动常见问题

  • 文档创建者:文档助手1
  • 历史版本:52
  • 最近更新:Carly 于 2023-12-01
  • 1. 概述

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

    2. 设计器闪退

    设计器产生闪退的常见原因如下:

    1)产品内的原因:

    • 内存不够

    • finedb有问题

    • 比如javafx实现的插件管理在windows下频繁使用会造成闪退(查明是javafx bug 升级jdk 或直接升级最新版 即可解决)

    2)系统原因:

    • 系统权限问题

    3)其他软件冲突:

    • 输入法dll导致

    • 其他系统或者三方软件的dll

    • 杀毒软件

    设计器闪退常见的排查思路如下图所示:

    2.1 设计器启动,加载至页面后闪退,打开 logs 文件夹下的 fanruan.log 日志文件有报错

    问题描述:设计器启动,加载至页面后闪退,打开 logs 文件夹下的 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

    2.2 设计器启动,加载至页面后闪退,没有报错日志

    原因分析:电脑系统存在问题

    解决方法:重新安装电脑系统

    2.3 设计器启动闪退,error.log中只打印了闪退,没有打印其他报错信息

    原因分析:设计器安装过程中存在异常

    解决方法:重装设计器,并对安装设计器的服务器的 jar 包进行升级,即可应用正常

    2.4 设计器启动一直闪退,查看日志发现引用了非安装磁盘下的工程

    原因分析:可能是工作目录的问题

    解决方法:找到 C 盘 xml 文件 保存激活码后删除 xml 文件,重启设计器

    2.5 设计器闪退, 修改内存到 4G 也出现闪退

    原因分析:设计器安装错误

    解决方法:确认电脑系统和安装设计器系统是否匹配,重新安装

    3. 设计器无法启动

    3.1 设计器全新安装,无法启动,打开 fanruan.log 日志文件存在报错

    问题描述:设计器全新安装,无法启动,打开 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用户)启动

    3.2 设计器安装后无法启动

    原因分析:

    1)缓存/内存问题

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

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

    解决方法:

    1)在「任务管理器」中结束进程 designer.exe 和 OpenJDK Platform binary,删除 C 盘的系统缓存,重启设计器;或清除缓存,用大内存启动,可参考:修改内存

    2)重新登录外接数据库,重启服务器。

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

    3.3 设计器 exe 启动无响应

    问题描述:设计器 exe 启动无响应,任务管理器中无设计器线程,bin下生成error.log,但error.log是空的,bat启动设计器正常。

    原因分析:系统中存在加密软件

    解决方法:将设计器添加到加密软件的白名单中即可。

    3.4 设计器无法启动,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.

    解决方法:

    1)排查是否为杀毒软件的问题。

    2)任务管理器里面搜索设计器进程,删除后重启设计器。

    3.5 jar 包替换后,设计器无法启动

    解决方法:重装设计器。

    3.6 开机后首次启动设计器卡在启动页面很长时间,然后报错-出现意外错误,关掉后重启正常

    解决方法:备份工程,重装设计器。

    3.7 设计器打开的时候停在启动动画

    解决方法:清除缓存后重启设计器。

    3.8 设计器无法启动,报错含JDK

    问题描述:设计器无法启动报错:OpenJDK 64-Bit Server VM warning: ignoring option MaxPermSize=128m; support was removed in 8.0

    解决方法:重装设计器。

    3.9 设计器无法打开,打开日志报错

    问题描述:设计器无法启动,打开日志报错:

    please check the database service to ensure that it is available jdbc:hsqldb:file://X:\FineReport_XX\webapps\webroot\WEB-INF/embed/finedb/db:hsqldb.tx=mvcc

    原因分析:Finedb 问题

    解决方法:删除db.lck文件,删除 C 盘缓存文件,重启设计器。

    3.10 启动设计器报错:发现与设计器端口冲突的进程,请结束进程或更改设计器端口

    解决方法:

    1)netstat -ano |findstr “端口号”   将在占用设计器端口号的进程筛选出来。

    2)找到对应的进程后,通过进程的pid查看对应的进程名。命令:tasklist |findstr "pid" 3)通过进程名称或PID杀掉该进程  命令:taskkill /f /t /im "进程id或者进程名称"。如:taskkill /f /t /im "java.exe" 或 taskkill /f /t /im "16516" 

    注:windows 系统其实在查到占用端口对应的 pid 或进程名后就可以通过任务管理器直接杀掉进程。

    3.11 11.0 设计器无法启动,报错为:Exception in thread' main” java. lang. NoClassDefF oundError: com/fr/base/theme/ThemedTemplate

    原因分析:JAR包错误

    解决方法:重新替换jar包

    3.12 设计器打开报错

    问题描述:设计器打开报错:please check the database service to ensure that it is  available jdbc

    原因分析:读取不到 finedb 数据库或者被多个工程读取导致冲突

    解决方法:

    1)清除本地缓存,C:\Users\用户目录下,删除整个缓存文件

    2)删除\webapps\webroot\WEB-INF\embed\finedb下的db.lck文件

    3)权限不够,这种情况打开\webapps\webroot\WEB-INF\embed\finedb一般会提示没有管理员权限,可以通过管理员身份打开设计器

    4)本地是否同时安装了设计器跟部署了服务器,有时候会同时读取finedb,导致冲突,解决办法:删除缓存文件,这个最直接,或者配置一下.FineReportXXX\FineReportEnv下的缓存路径,不要跟tocmat冲突

    5)配置过外置数据库,但是有迁移回去了,或者不知名原因,出现了db.properties文件,这时删除/webapps/webroot/WEB-INF/config下的db.properties文件就行

    3.13 打开设计器一直停在加载页面

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

    原因分析:报错提示 Java 内存溢出,只是由于设计器内存分配不够导致的。
    解决方案:编辑器打开%FR_HOME%\bin\designer.vmoptions,将设计器内存调大一些,修改设计器内存的方法参见文档:修改内存

    3.14 finereportEnv.xml 文件损坏

    问题描述:设计器启动失败,弹出报错提示信息:抱歉!设计器启动出现预期外的错误,问题详细信息显示:-1

    解决方案:这是由于系统盘 .FineReport110 文件夹内的 finereportEnv.xml 文件损坏导致的,删除该文件即可,如下图所示:

    3.15 国产化设计器安装后无法启动

    问题描述:中标麒麟ARM系统,linux内核,安装10.0linu版设计器,

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

    Failed  to load  /etc/os-release

    解决方案:

    1)第一个报错可以不关注,可以正常启动

    2)第二个报错为环境的问题,可以先确认下linux环境是否存在/etc/os-release这个文件

    4. 设计器重启

    4.1 设计器保存失败,甚至直接闪退重启。

    问题描述:设计器保存失败,甚至直接闪退重启。服务器报错:Exception caught during execution of add command

    原因分析:内存满了

    解决方法:清理磁盘

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

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

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

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

           方法1:重启电脑。

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

    5. 设计器启动后异常

    5.1 The JVM could not be started

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

    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

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

    1574665951480263.png

    5.2 设计器页面错乱

    问题描述:当使用设计器远程服务器进行报表设计的时候,有时候会出现设计器卡死问题。当我们再次登录设计器时候,发现设计器显示页面错乱,有时会有英文产生。

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

    5.3 FineDB 损坏

    问题描述:打开设计器,报错:配置数据库出错,是否重置?将在 embed 文件夹下生成备份并重置。如下图所示:

    注:FineDB 损坏重置之后,生成的 FineDB 是没有数据的 ,重置须谨慎。

    原因分析:

    1)产品装在 C 盘,因为 C 盘需要用户的权限比较大,有可能会出现这种问题。

    2)非管理打开设计器,对安装软件的文件夹没有读写权限。

    解决方案:

    1)卸载后安装在 D 盘。

    2)使用管理员账号打开设计器,或者提高用户对文件夹的读写权限。

    5.4 设计器残留进程占用 FineDB

    问题描述:设计器启动时如果弹出报错提示信息:上次设计器进程未正常关闭,是否结束进程并重启,如下图所示:

    解决方案:

    1)点击结束进程:结束显示的进程并重启设计器。

    2)点击取消关闭:取消设计器启动,并在后台杀掉进程。

    5.5 端口被其他进程占用

    问题描述:设计器启动时如果弹出报错提示信息:发现与设计器端口冲突的进程,请结束进程或更改设计器端口,表示设计器的端口被其他进程占用。如下图所示:

    解决方案:点击更改端口后,弹出更改端口号的提示框,用户可以在文本框中填写新的端口号。

    注1:设计器内置服务器端口默认为 8075,点击设计器中的预览方式查看报表时使用这个端口;51462 为设计器默认端口,用来防止设计器多开。所以更改端口号时应避免填写这两个端口,以防填写重复值再次导致冲突。

    注2:端口号范围在 1024~65535 之间。

    5.6 未知启动问题

    问题描述:设计器启动遇到未知错误时,会弹出报错提示信息:抱歉!设计器启动出现预期外的错误

    解决方案:

    1)点击重启:重新启动设计器。

    2)点击:同时关闭弹窗和设计器。杀掉进程重启设计器或重新安装后重启。

    5.7 设计器支离破碎, 显示不全

    原因分析:可能是 jdk1.8 的bug。

    解决方案:安装内置 jdk1.7 的设计器 windows_FineReport-CN_jdk1_7.exe

    5.8 设计器页面会跟着鼠标跑,出现重影

    问题描述:只要打开设计器,页面就会跟随鼠标出现无数重影,完全无法正常使用,重启、重装设计器都不行

    解决方案:显卡驱动问题,关闭java3d即可。在designer.vmoptions 配置参数  -Dsun.java2d.d3d=false

    5.9 设计器输入中文闪退

    问题描述:设计器安装后,英文输入正常。切换中文输入法输入,设计器直接闪退。

    原因分析:jvm把字节码转换成机器码出错了。这个基本是个jdk bug,可以切换jvm的模式(默认是混合模式)

    解决方案:找到设计器安装路径,%FR_HOME%bin目录下的designer.vmoptions文件。最下面配置-Xint参数,避免将字节码转换成机器码,强制JVM执行所有的字节码。

    5.10 设计器出现重影

    问题描述:更换电脑后,目前分辨率为2560*1600,出现设计器错位这种情况

    解决方案:在designer.vmoptions 配置了一下参数 -Dsun.java2d.d3d=false,重启即可解决

    5.11 设计器打开白屏

    问题描述:任意版本设计器打开都是白屏,重装设计器也是如此

    解决方案:在designer.vmoptions 配置了一下参数 -Dsun.java2d.d3d=false,重启即可解决。

    5.12 设计器无法登录通行证/自动更新/下载插件

    问题描述:

    1)网络情况是使用网络代理,设计器启动正常,但在设计器和数据决策系统中无法登录帆软通行证。

    2)网络情况是使用网络代理,设计器无法自动更新或下载插件。

    原因分析:

    11.0.8 之前版本设计器不支持网络代理。

    解决方案:

    可参考:FineReport外网地址

    附件列表


    主题: 安装与升级
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持