设计器启动常见问题

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

2.1 问题描述

在 windows8 或 windows10 系统下，安装 FineReport 软件可能会提示有风险，阻止安装该软件，弹窗提示：这种类型的文件可能会危害你的计算机，如下图所示：

2.2 原因分析

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

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

2.3 解决方法

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

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

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

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

5.1 问题描述

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

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

5.2 解决方法

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

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

       方法1：重启电脑。

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

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 的值改小一点，修改后重启设计器即可。如下图所示：

7.1 问题描述

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

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

7.2 解决方法

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

8.1 问题描述

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

• 单元格：

• 公式编辑框：

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 以上。

9.1 问题描述

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

9.2 原因分析

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

9.3 解决方案

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

10.1 问题描述

打开设计器，报错：配置数据库出错，是否重置？将在 embed 文件夹下生成备份并重置。如下图所示：

10.2 原因分析

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

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

10.3 解决方案

1）卸载后安装在 D 盘。

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