1.1 问题描述

• 预览模板时报错内存溢出：java.lang.OutOfMemoryError:Java heap space

• Tomcat 后台提示 Memory is over threshold

• 报错：gc overhead

• 报错：内存溢出

• FineReport 内存占用过高

• 想调整设计器默认内存
  

• 想调整 Tomcat 默认内存

• 设计器用久了响应速度慢，出现卡顿
  

• 预览模板经常出现等待排队中

• 服务器压力大

1.2 原因分析

这些报错和现象，往往是由于服务器的 JVM 不够用而抛出的错误，JVM 在启动的时候会自动设置 heap size 的值。

当 heap size 设置偏小，除了报异常信息外，还会发现执行报表的速度变慢了。

1.3 解决思路

为了避免内存溢出的问题，用户应当适当调整服务器/设计器内存大小，并适当启用磁盘缓存功能。

本文将详细说明如何调整 Tomcat 服务器内存大小、如何调整设计器内存大小、如何开启磁盘缓存功能。

本文仅介绍Tomcat类型服务器内存的修改方法。

建议修改的内存相关配置项包括：

2.1 通过startup.bat、startup.sh启动

若 Tomcat 是通过 startup.bat、startup.sh 启动的，参考本章方法修改服务器内存。

2.1.1 Linux

1）进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。

注：请确保setenv.sh文件具有可执行权限。如果没有可执行权限，可以使用以下命令进行设置：chmod +x setenv.sh

2）使用文本编辑器打开setenv.sh文件。在文件最上面添加以下行来设置：

JAVA_OPTS="$JAVA_OPTS -Xms8192M -Xmx8192M -Xss1024k"

JAVA_OPTS="$JAVA_OPTS -XX:MaxDirectMemorySize=2g"

JAVA_OPTS="$JAVA_OPTS -Dfineio.read_mem_limit=2"

JAVA_OPTS="$JAVA_OPTS -Dfineio.write_mem_limit=1"

3）保存并关闭setenv.sh文件。

4）重启Tomcat服务器以使修改生效。

2.1.2 Windows

1）进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。

2）使用文本编辑器打开setenv.bat文件。在文件最上面添加以下行来设置：

set JAVA_OPTS=%JAVA_OPTS% -Xms8192M -Xmx8192M -Xss1024k

set JAVA_OPTS=%JAVA_OPTS% -XX:MaxDirectMemorySize=2g

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.read_mem_limit=2

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.write_mem_limit=1

3）保存并关闭setenv.bat文件。

4）重启Tomcat服务器以使修改生效。

2.2 Tomcat 为安装版本

若通过服务启动 Tomcat，即不是通过 startup.bat、startup.sh 启动 Tomcat 的，参考本章方法解决。

本章以 Win10+Tomcat8+JDK1.8 为例（不同版本可能略有不同请自行处理）。

2.2.1 方法一

1）直接双击 Tomcat 出现在屏幕右下角的系统托盘，打开Java选项卡，修改Initial Memory Pool和Maximum Memory Pool即可。

前者为初始内存，后者为最大内存，最大内存尽量不要超过物理内存的 80% 。

2）修改后，重启 Tomcat 设置生效。

2.2.2 方法二

1）在注册表编辑器中，找到HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\Tomcat8\Parameters\Java（路径可能有一点差别）。

修改 JvmMs（初始化内存）和 JvmMx（最大内存）：

2）重启Tomcat，设置生效。

2.3 验证修改是否成功

管理员登录工程的数据决策系统，选择「管理系统>智能运维>负载管理>负载监控」，可以看到实时内存情况，如下图所示：

3.1 Windows

1）关闭设计器。

2）进入%FR_HOME%\bin目录，寻找designer.vmoptions文件。

3）使用文本编辑器打开designer.vmoptions文件，修改 Xmx 值。保存并关闭文件。

4）重启设计器生效。

3.2 Mac

1）关闭设计器。

2）进入%FR_HOME%\bin目录，右击designer.app，点击「显示包内容」。

3）打开Content/vmoptions.txt文件，修改 Xmx 值。保存并关闭文件。

4）重启设计器生效。

3.3 验证修改是否成功

管理员登录设计器的数据决策系统，选择「管理系统>智能运维>负载管理>负载监控」，可以看到实时内存情况，如下图所示：

在系统根目录有个 .FineReport110 文件夹，这个目录下的所有文件都是服务器生成的。

其中有个 ./ehcache_disk_store 文件，经常占用非常大的空间，导致根目录很容易就满了。

请参考 指定ehcache缓存路径 文档修改 ./ehcache_disk_store 存放路径。