Apache FOP自定义格式图片转换后在生成PDF中不显示问题咨询

核心问题定位方向 #

• 元数据丢失问题
  你当前代码直接复用自定义格式的originalInfo生成ImageRawPNG，但转换后PNG的真实宽高、色深、DPI等属性没有同步到返回的ImageRawPNG实例中。FOP渲染时会校验图片尺寸参数，如果拿到的宽高为0或者和FO声明的不匹配，会直接跳过图片渲染。
  解决办法：获取转换后PNG的真实参数，手动覆盖Image实例的属性：

  // 从转换后的PNG中读取真实尺寸
  PNGImageReader reader = (PNGImageReader) ImageIO.getImageReadersByFormatName("png").next();
  reader.setInput(ImageIO.createImageInputStream(new ByteArrayInputStream(outBuffer.toByteArray())));
  int width = reader.getWidth(0);
  int height = reader.getHeight(0);
  // 同步到ImageRawPNG
  image.getSize().setDimension(width, height);
  image.getSize().setResolution(96, 96); // 和你PNG的实际DPI保持一致
  

• 流被提前消费问题
  你用ByteArrayInputStream构建PNGFile实例后，PNGFile读取文件头的操作会将流的指针移动到末尾，后续FOP读取PNG内容时会拿到空流，导致图片数据缺失。
  解决办法：返回ImageRawPNG前重置流指针，或者直接用字节数组构建新的流给ImageRawPNG：

  // 方案1：重置原有流指针
  convertedStream.reset();
  // 方案2：直接传入新的流实例，避免指针问题
  ImageRawPNG image = new ImageRawPNG(originalInfo, new ByteArrayInputStream(outBuffer.toByteArray()), width, height);
  

• 返回的ImageFlavor不匹配渲染链路
  FOP的PDF渲染器默认优先处理RenderedImage类型的图片，你返回的RAW_PNG属于原始流类型，可能后续的处理链路没有正确适配。
  解决办法：修改Converter逻辑，直接返回RenderedImage类型的实例，跳过RawPNG的中间环节：

  BufferedImage renderedImg = ImageIO.read(new ByteArrayInputStream(outBuffer.toByteArray()));
  ImageRendered targetImg = new ImageRendered(originalInfo, renderedImg, null);
  return targetImg;
  

辅助验证手段 #

将FOP的日志级别调整到TRACE，查看图片Adapter创建后的处理流程，确认是否有格式解析、数据读取的异常被静默吞掉。

内容的提问来源于stack exchange，提问作者R. Sieger