JasperPrint使用JSON数据源生成报表时详情带无有效数据问题

以下是实际开发中常见的排查和解决方法：

1. 对齐JSON查询节点配置 #

Jaspersoft Studio的DataAdapter会自动识别你设置的查询路径，但Java代码里如果没指定，默认只会读取JSON的顶层对象，导致详情带无法循环渲染数据。

• 先查看JRXML里的查询语句：比如<queryString language="json">标签内写的是$.orders，那代码里必须对应指定这个路径：

  // 示例：从本地文件加载JSON并指定查询节点
  File jsonFile = new File("order_data.json");
  JsonDataSource dataSource = new JsonDataSource(new FileInputStream(jsonFile), "$.orders");
  

• 如果JRXML里用参数传递查询（比如定义了<parameter name="JSON_QUERY" class="java.lang.String"/>），要把查询字符串放入参数Map：

  Map<String, Object> params = new HashMap<>();
  params.put("JSON_QUERY", "$.orders");
  JasperPrint print = JasperFillManager.fillReport(report, params, new JsonDataSource(jsonInputStream));
  

2. 验证字段表达式的JSON路径 #

确保JRXML里的字段表达式和JSON结构完全匹配：

• 比如JSON结构是：

  {
    "orders": [
      {"orderId": 1001, "goodsName": "无线耳机"},
      {"orderId": 1002, "goodsName": "机械键盘"}
    ]
  }
  

  JRXML里的字段表达式要写$.orderId、$.goodsName，而不是仅依赖字段名$F{orderId}——$F{orderId}是报表字段名，背后的表达式必须准确指向JSON的键路径。
• 注意大小写！JSON键区分大小写，别把goodsName写成goodsname。

3. 确保JSON数据加载无异常 #

• 避免输入流提前关闭：

  // 错误写法：流在创建数据源后就被关闭
  try (FileInputStream fis = new FileInputStream(jsonFile)) {
      dataSource = new JsonDataSource(fis, "$.orders");
  }
  // 正确写法：先把JSON读成字符串，或填充报表时保持流打开
  String jsonStr = Files.readString(jsonFile.toPath(), StandardCharsets.UTF_8);
  JsonDataSource dataSource = new JsonDataSource(new StringReader(jsonStr), "$.orders");
  

• 打印代码中加载的JSON字符串，确认和Studio里测试的完全一致，没有编码乱码或数据缺失。

4. 检查报表文件的加载方式 #

• 如果直接加载JRXML文件，要先完成编译：

  JasperReport report = JasperCompileManager.compileReport("order_report.jrxml");
  

• 如果加载编译好的.jasper文件，确保文件是最新版本，和Studio里测试的报表配置一致。

5. 排除参数冲突 #

如果JRXML里定义了REPORT_DATA_SOURCE这类参数，不要在代码的参数Map里重复设置，以免覆盖你传入的JsonDataSource。

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