1. 概述
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 服务器内存大小、如何调整设计器内存大小、如何开启磁盘缓存功能。
2. 修改Tomcat服务器内存
本文仅介绍Tomcat类型服务器内存的修改方法。
建议修改的内存相关配置项包括：
| 内存配置参数 | 说明 | 建议值 |
|---|---|---|
| Xmx | 指定Java堆的最大内存大小 它设置堆的上限，当堆大小达到该值时，JVM将停止分配新的内存并触发垃圾回收 | 建议： 8GB <= Xmx < 32 GB或者 40GB <= Xmx <= 64GB 注：< 8GB 有宕机风险，32GB ~ 40GB 会导致性能问题，> 64GB 性能差 用户可在 健康巡检 查看推荐的「堆内内存」大小（Xmx 值） |
| Xms | 指定Java堆的初始内存大小 它设置堆的初始大小，JVM会在启动时分配该大小的内存 | 建议 Xms = Xmx |
Xss | 单线程使用栈空间 | 建议 Xss 的值不超过 1024 该参数一般无需配置，可查看原始值并自行调小 |
| MaxDirectMemorySize | 堆外NIO内存，指定直接内存（Direct Memory）的最大大小 直接内存不受Java堆大小的限制，通过本地内存直接分配，而不是在Java堆中分配 | 建议 2GB，参考值2~4GB 最小2GB，不限制最大值，但需要考虑用户服务器内存的大小，FineBI 使用的内存（BIMax）<= 用户服务器内存 * 7/8 |
| Dfineio.read_mem_limit | fineIO读内存 | 建议 2GB |
| Dfineio.write_mem_limit | fineIO写内存 | 建议 1GB |
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. 修改设计器内存
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 验证修改是否成功
管理员登录设计器的数据决策系统，选择「管理系统>智能运维>负载管理>负载监控」，可以看到实时内存情况，如下图所示：
4. 修改缓存路径
在系统根目录有个 .FineReport110 文件夹，这个目录下的所有文件都是服务器生成的。
其中有个 ./ehcache_disk_store 文件，经常占用非常大的空间，导致根目录很容易就满了。
请参考 指定ehcache缓存路径 文档修改 ./ehcache_disk_store 存放路径。
