Spring环境下Jasper组页脚子报表仅在首页填充的异常问题

• 子报表使用的JRBeanCollectionDataSource属于带遍历游标的有状态对象：当对象被读取完全部数据行后，游标会固定停留在结果集末尾，后续所有读取动作都返回空数据，不会自动回到结果集起点。
• Jaspersoft Studio预览效果正常的原因：Studio在每次渲染流程中，会为每处子报表调用独立的数据源初始化逻辑，不会跨渲染节点复用同一个已被游标遍历耗尽的数据源实例，和Spring服务端的运行逻辑存在本质差异。
• 调整「无数据处理类型」后仅显示列头的原因：该配置的触发条件是主报表自身绑定的数据源返回空结果集，和子报表数据源无有效数据的场景完全不匹配，因此仅会输出静态列头框架，不会加载任何动态明细内容。

1. 解耦数据源传递逻辑 #

禁止将已经实例化的JRBeanCollectionDataSource对象作为全局参数传入子报表，改为传递原始实体集合，在子报表渲染时动态构建全新的数据源实例，从根本上避免游标耗尽问题：

• 调整Java代码逻辑：

Map<String, Object> parameters = new HashMap<>();
parameters.put("TEMPLATE_XML", compiledSubReport);
// 替换原来传入JRBeanCollectionDataSource的逻辑，直接传入原始实体列表
List<Entity> entityList = util.getEntities();
parameters.put("ENTITY_LIST", entityList);
return JasperFillManager.fillReport(mainReport, parameters, mainDataSource);

• 调整JRXML中组页脚内子报表的数据源表达式：

<dataSourceExpression><![CDATA[new net.sf.jasperreports.engine.data.JRBeanCollectionDataSource($P{ENTITY_LIST})]]></dataSourceExpression>

2. 组页脚渲染规则校验 #

如果需要子报表随每一页固定展示，需校验组的触发逻辑：

• 检查组对应的footerPosition、keepTogether配置，避免组页脚因为空间不足被移动到下一页，导致第一页之后的内容无触发渲染的锚点。
• 若需要跨页固定展示组页脚，可给组页脚band添加打印触发规则，绑定页码变化的内置变量，确保每一页渲染时都会重新触发组页脚的绘制。

3. 快速根因验证 #

可在子报表的数据源表达式中临时添加游标重置逻辑，快速定位问题：

<dataSourceExpression><![CDATA[($P{TEMPLATE_DATA}).moveFirst(); $P{TEMPLATE_DATA}]]></dataSourceExpression>

如果验证后所有页面的子报表都能正常展示，即可确认是游标未重置导致的问题。

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