设计器启动守护

1.1 版本介绍

1.2 应用场景

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

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

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

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

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

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

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

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

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

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

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

设计器启动时如果弹出下弹出报错信息：配置数据库出错，是否重置？将在embed文件夹生成备份并重置，表示 FineDB 会因为某些原因存在损坏的情况，导致设计器启动失败。

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

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

删除 FineDB 文件夹和备份都不行，最后是以管理员身份重启报表工具。

可以不用删除 FineDB 文件夹，点击取消或关闭以管理员身份重启报表工具。

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

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

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

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

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

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

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

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

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

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

• 点击好或关闭：关闭设计器启动进程。

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

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

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