JasperReports Server v7 如何配置AdHoc Cache优化报表加载速度

通用优化方案（优先落地，可快速降低耗时） #

• 优化REST API数据源：先在Jasper Studio中开启查询日志，排查接口响应、数据序列化环节的耗时，对接口返回字段做裁剪，只保留报表必需的字段，避免冗余数据传输。如果接口支持分页，可针对大体积报表配置分页拉取逻辑，避免单次拉取全量数据。
• 优化报表本身逻辑：删除报表中未使用的变量、参数、隐藏组件，图表所需的聚合计算尽量配置在报表服务侧预执行，避免前端加载时做大量计算。如果是多图表联合报表，可配置懒加载规则，非首屏图表延迟渲染。
• 优化Docker运行环境：给Jasper Server容器分配至少4G内存、2核以上CPU资源，修改容器内的setenv.sh配置，调整JVM堆内存参数：export JAVA_OPTS="-Xms4G -Xmx8G -XX:+UseG1GC"，避免GC卡顿导致的加载耗时升高。

Ad-Hoc Cache v7版本Docker环境配置方案 #

Ad-Hoc Cache在v7版本为官方支持的有效优化方案，配置逻辑和v4.7版本有差异，Docker环境下的操作步骤如下：

1. 进入运行中的Jasper Server容器：
   docker exec -it <你的jasper容器名> bash
2. 定位到缓存配置文件目录：
   cd /usr/local/share/jasperreports-server/webapps/jasperserver/WEB-INF
3. 编辑ehcache-adhoc.xml配置文件，调整缓存规则参数，可根据实际数据量修改：

<cache name="AdhocCache"
       maxEntriesLocalHeap="10000"
       maxEntriesLocalDisk="100000"
       eternal="false"
       timeToIdleSeconds="3600"
       timeToLiveSeconds="7200"
       overflowToDisk="true"
       diskPersistent="true"
       diskExpiryThreadIntervalSeconds="120"
       memoryStoreEvictionPolicy="LRU"/>

4. 编辑applicationContext-adhoc.xml文件，开启缓存开关：
   找到adhocCacheService bean配置项，将disabled属性改为false：
   <property name="disabled" value="false"/>
5. 针对REST API数据源开启适配，编辑jasperserver.properties文件，添加以下配置：

adhoc.cache.enabled=true
adhoc.cache.for.query.execution=true
adhoc.cache.include.data.sources=restApiDataSource

6. 退出容器，重启容器使配置生效：
   docker restart <你的jasper容器名>

• 配置生效后，相同参数的报表首次加载仍会走原始请求逻辑，后续重复请求会直接读取缓存，可降低80%以上的重复加载耗时。如果需要更新缓存数据，可在Jasper Server管理后台的缓存管理页面手动清除对应缓存条目。

内容的提问来源于stack exchange，提问作者JAMSHAID