Spring Boot Native应用中PDFBox渲染PDF图片报错求助

我在基于Spring Boot 3.2.1的Native原生应用中使用PDFBox 2.0.30渲染PDF文档中的图片，PDF生成功能正常，但图片渲染失败。调用PDFRenderer#renderImage(int, float)将PDDocument转换为图片时抛出如下错误：

java.lang.NoSuchFieldError: sun.java2d.pipe.ShapeSpanIterator.pData
        at org.graalvm.nativeimage.builder/com.oracle.svm.core.jni.functions.JNIFunctions$Support.getFieldID(JNIFunctions.java:1357) ~[na:na]
        at org.graalvm.nativeimage.builder/com.oracle.svm.core.jni.functions.JNIFunctions.GetFieldID(JNIFunctions.java:449) ~[na:na]
        at java.desktop@21.0.1/sun.java2d.pipe.ShapeSpanIterator.initIDs(Native Method) ~[na:na]
        at java.desktop@21.0.1/sun.java2d.pipe.ShapeSpanIterator.<clinit>(ShapeSpanIterator.java:71) ~[na:na]
        at java.desktop@21.0.1/sun.java2d.pipe.LoopPipe.getFillSSI(LoopPipe.java:228) ~[na:na]
        at java.desktop@21.0.1/sun.java2d.SunGraphics2D.validateCompClip(SunGraphics2D.java:1911) ~[na:na]
        at java.desktop@21.0.1/sun.java2d.SunGraphics2D.setClip(SunGraphics2D.java:2046) ~[na:na]
        at org.apache.pdfbox.rendering.PageDrawer.transferClip(PageDrawer.java:440) ~[na:na]
        at org.apache.pdfbox.rendering.PageDrawer.setClip(PageDrawer.java:411) ~[na:na]
        at org.apache.pdfbox.rendering.PageDrawer.beginText(PageDrawer.java:447) ~[na:na]
        at org.apache.pdfbox.contentstream.operator.text.BeginText.process(BeginText.java:41) ~[na:na]
        at org.apache.pdfbox.contentstream.PDFStreamEngine.processOperator(PDFStreamEngine.java:958) ~[awt-native-test:2.0.30]
        at org.apache.pdfbox.contentstream.PDFStreamEngine.processStreamOperators(PDFStreamEngine.java:531) ~[awt-native-test:2.0.30]
        at org.apache.pdfbox.contentstream.PDFStreamEngine.processStream(PDFStreamEngine.java:506) ~[awt-native-test:2.0.30]
        at org.apache.pdfbox.contentstream.PDFStreamEngine.processPage(PDFStreamEngine.java:150) ~[awt-native-test:2.0.30]
        at org.apache.pdfbox.rendering.PageDrawer.drawPage(PageDrawer.java:288) ~[na:na]
        at org.apache.pdfbox.rendering.PDFRenderer.renderImage(PDFRenderer.java:355) ~[na:na]
        at org.apache.pdfbox.rendering.PDFRenderer.renderImage(PDFRenderer.java:272) ~[na:na]
        at org.apache.pdfbox.rendering.PDFRenderer.renderImage(PDFRenderer.java:232) ~[na:na]
        at com.vialink.awtnativetest.PDFService.toImage(PDFService.java:37) ~[awt-native-test:na]
        ...

环境信息 #

• 应用类型：Spring Webflux（项目名awt-native-test）
• 构建命令：mvn native:compose -Pnative（通过Native Maven Plugin构建本地可执行文件）
• 运行命令：./target/awt-native-test
• Java版本：

openjdk version "21.0.1" 2023-10-17 LTS
OpenJDK Runtime Environment Liberica-NIK-23.1.1-1 (build 21.0.1+12-LTS)
OpenJDK 64-Bit Server VM Liberica-NIK-23.1.1-1 (build 21.0.1+12-LTS, mixed mode, sharing)

疑问 #

我猜测需要为Java2D添加运行时提示以适配PDFBox（比如类似hints.jni().registerType(ShapeSpanIterator.class, MemberCategory.values());的配置），但sun.java2D.pipe属于未导出的内部模块，不知道该如何操作。请问我遗漏了什么配置？PDFBox的图片渲染功能是否支持Native原生环境？

1. PDFBox对Native环境的支持现状 #

PDFBox 2.x官方未明确宣称完全支持GraalVM Native Image，其渲染模块依赖Java2D的内部API，这类API在Native编译时容易被GraalVM裁剪，或无法正确绑定JNI，导致字段/方法找不到的错误。

2. 添加GraalVM反射配置 #

针对sun.java2d.pipe下的内部类，需要通过反射配置让GraalVM在Native编译时保留相关成员：

• 在src/main/resources/META-INF/native-image目录下创建reflect-config.json文件，添加以下内容：

  [
    {
      "name": "sun.java2d.pipe.ShapeSpanIterator",
      "allDeclaredFields": true,
      "allDeclaredMethods": true,
      "allDeclaredConstructors": true
    },
    {
      "name": "sun.java2d.pipe.LoopPipe",
      "allDeclaredMethods": true
    }
  ]
  

• 确保Native Maven Plugin包含该配置目录，在pom.xml中补充：

  <plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <configuration>
      <resourcesDirectory>src/main/resources</resourcesDirectory>
    </configuration>
  </plugin>
  

3. 尝试版本升级或替代方案 #

• 切换到PDFBox 3.0.0+（测试版）：该版本对GraalVM Native Image的兼容性有针对性优化，部分内部API依赖已调整。
• 替换为第三方库：如OpenPDF、iText 7，这些库对Native环境的支持更成熟，避免依赖Java2D内部API。

4. Liberica NIK专属配置优化 #

由于使用的是Liberica NIK，可以在Native编译时添加专属参数，确保Java2D模块被完整包含：
在pom.xml的Native插件配置中添加构建参数：

<plugin>
  <groupId>org.graalvm.buildtools</groupId>
  <artifactId>native-maven-plugin</artifactId>
  <configuration>
    <buildArgs>
      <arg>--enable-all-security-services</arg>
      <arg>--enable-preview</arg>
      <arg>--initialize-at-build-time=sun.java2d.pipe.ShapeSpanIterator</arg>
    </buildArgs>
  </configuration>
</plugin>

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