历史版本6 :设计器启动守护说明 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本介绍

报表服务器版本JAR 包版本
10.02020-04-26

1.2 应用场景

目前设计器启动时,容易因为各种各样的原因而卡死或者闪退,这种问题往往难以排查,又会给用户带来不好的使用体验。

为了处理设计器启动问题,2020-04-26 版本的 JAR 包新增设计器守护功能。

2 设计器残留进程占用 FineDB编辑

设计器启动时如果弹出报错提示信息:上次设计器进程未正常关闭,是否结束进程并重启,表示设计器上次启动的进程未结束。

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

  • 点击取消关闭:取消设计器启动。

1587539155945139.png

3. 端口被其他进程占用编辑

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

  • 点击更改端口:另外弹框进行端口的修改,端口修改成功并确定后重启设计器。

  • 点击结束进程关闭:取消设计器启动。

1587539593884250.png

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

注1:设计器默认端口为 51462 ,更改端口号不要填写重复值。

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

端口2.png

4. FineDB 损坏编辑

设计器启动时如果弹出下图所示提示框,表示 FineDB 会因为某些原因存在损坏的情况,导致设计器启动失败。

点击重置:删除 FineDB ,并在 embed 下生成备份文件夹 finedb_bak ,随后继续启动。
点击取消关闭:关闭设计器启动进程。

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

1587540017248639.png

5. 远程设计服务器无响应编辑

设计器启动时如果弹出报错提示信息:远程连接时间过长是否继续等待,表示设计器上次是在远程设计状态下关闭的,再次启动时,如果服务器直接关闭或者连不上时,会直接弹窗让用户切换工作目录,但是如果服务器处于宕机等情况时,远程连接就会一直等待,导致设计器一直卡在启动界面,而且没有默认的超时设置。

  • 点击继续等待:关闭弹窗重新计算一分钟,一分钟后重复提示。

  • 点击切换目录:关闭弹窗,弹出远程连接失败后切换工作目录的窗口。

1587540116587692.png

6. 未知启动问题编辑

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

  • 点击重启:重新启动设计器。

  • 点击:同时关闭弹窗和设计器。

  • 点击左上角关闭:只关闭弹窗。

1587540293378458.png

注:该弹窗只有 Windows 版本的设计器有,macOS 版本的设计器没有该弹窗。

7. 设计器闪退编辑

设计器发生闪退时,会弹出报错提示信息:抱歉!设计器启动出现预期外的错误,问题详细信息显示:预期外的闪退错误

  • 点击重启:重新启动设计器。

  • 点击关闭:关闭设计器启动进程。

Snag_496e0bc.png

注:该弹窗只有 Windows 版本的设计器有,macOS 版本的设计器没有该弹窗。

8. finereportEnv.xml 文件损坏编辑

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

2.png

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

1591581774254348.png