使用iReport生成报表时参数未找到的JRValidationException问题

核对JRXML模板参数定义 #

• 确保caisse2.jrxml中<parameter>标签的名称完全匹配Java代码传入的参数名，Java大小写敏感，比如模板里是num，代码里不能写成Num或NUM。
• 确认参数的数据类型一致：比如模板定义compte为java.lang.Integer，代码传参时不能用String类型值填充。
• 检查参数定义位置：所有参数必须放在<jasperReport>根标签下的<parameters>节点内，不能嵌套在<fields>或其他节点中。

检查Java代码传参逻辑 #

• 在MetierImpl的报表生成方法中，必须通过Map完整传入所有模板定义的参数，哪怕值为null也要显式添加：

  Map<String, Object> params = new HashMap<>();
  params.put("num", "CA-001");
  params.put("compte", 1001);
  // 依次添加剩余7个参数
  JasperPrint print = JasperFillManager.fillReport(jasperReport, params, new JRBeanArrayDataSource(dataArray));
  

• 确认调用fillReport时，参数Map是第二个入参，不要和数据源位置搞混。

验证模板编译与加载 #

• 直接用iReport工具编译caisse2.jrxml，如果工具内报错，说明模板本身参数定义有问题（比如语法错误）；如果工具编译正常，检查Java代码加载的是否是最新编译的.jasper文件，避免加载旧版本模板。

区分参数与字段 #

• 排查模板是否混淆了<parameter>和<field>：你用数组数据源，字段是从数组元素中提取的属性，而参数是外部传入的值，不要把需要传参的项定义成<field>，反之亦然。

统一依赖版本 #

• 确保项目中JasperReports依赖的版本和iReport工具版本一致，版本不兼容会导致参数解析异常。比如iReport用6.19.0，项目依赖也要用对应版本的JasperReports jar包。

内容的提问来源于stack exchange，提问作者Bertrand Orou ganni