Java+Processing中使用FX2D渲染选项崩溃的解决方法

问题背景 #

在Java项目中使用Processing，导入core依赖后尝试使用FX2D渲染选项以获得更佳画质，程序启动即崩溃；不指定渲染选项时可正常运行。核心异常如下：

java.lang.NoClassDefFoundError: com/sun/javafx/geom/Shape
    at java.base/java.lang.Class.getDeclaredConstructors0(Native Method)
    at java.base/java.lang.Class.privateGetDeclaredConstructors(Class.java:3405)
    at java.base/java.lang.Class.getConstructor0(Class.java:3610)
    at java.base/java.lang.Class.getConstructor(Class.java:2303)
    at processing.core.PApplet.makeGraphics(PApplet.java:2234)
    ...
Caused by: java.lang.ClassNotFoundException: com.sun.javafx.geom.Shape
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    ...

测试代码：

package game;

import processing.core.PApplet;

public class GameSketch extends PApplet {

    @Override
    public void settings() {
        fullScreen(FX2D);
    }

    @Override
    public void setup() {
        background(255);
        frameRate(60);
        smooth(4);
    }

    @Override
    public void draw() {
        background(255);
        fill(0);
        textSize(104);
        text("Hello World!", width / 2, height / 2);
    }

    public void run() {
        String[] processingArgs = {this.getClass().getName()};
        PApplet.runSketch(processingArgs, this);
    }
}

已尝试导入所有Processing库、修改导入语句为import processing.core.*，问题仍存在。

错误根源 #

1. JDK版本兼容性：com.sun.javafx.geom.Shape是JavaFX内部API，Java 9及以上版本默认隐藏该类，而Processing的FX2D渲染器依赖此API。
2. 依赖缺失：仅导入Processing core依赖不足以支持FX2D渲染，需额外引入JavaFX相关的Processing模块。

解决方案 #

1. 匹配Processing与JDK版本 #

• 若使用Processing 4.x：优先选择JDK 17（如Adoptium Temurin 17，已整合JavaFX，适配性最佳）
• 若使用Processing 3.x：推荐使用JDK 8（保留com.sun.javafx系列内部API，无需额外参数配置）

2. 添加FX2D专属依赖 #

使用Maven管理时，在pom.xml中添加与Processing core版本一致的java-fx依赖：

<dependencies>
    <!-- Processing Core 依赖 -->
    <dependency>
        <groupId>org.processing</groupId>
        <artifactId>core</artifactId>
        <version>4.2</version> <!-- 替换为你的Processing版本 -->
    </dependency>
    <!-- FX2D渲染所需的JavaFX依赖 -->
    <dependency>
        <groupId>org.processing</groupId>
        <artifactId>java-fx</artifactId>
        <version>4.2</version> <!-- 版本必须与core保持一致 -->
    </dependency>
</dependencies>

3. JDK 9+ 额外配置JVM参数 #

若坚持使用JDK 9及以上版本，需在Maven exec插件中添加参数允许访问JavaFX内部API。修改pom.xml中的exec插件配置：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.0.0</version>
    <configuration>
        <executable>java</executable>
        <arguments>
            <!-- 开放FX2D所需的内部API权限 -->
            <argument>--add-exports</argument>
            <argument>javafx.graphics/com.sun.javafx.geom=ALL-UNNAMED</argument>
            <argument>--add-exports</argument>
            <argument>javafx.graphics/com.sun.javafx.geom.transform=ALL-UNNAMED</argument>
            <argument>--add-exports</argument>
            <argument>javafx.graphics/com.sun.javafx.scene.text=ALL-UNNAMED</argument>
            <argument>-classpath</argument>
            <classpath/>
            <argument>game.App</argument> <!-- 替换为你的主类全限定名 -->
        </arguments>
    </configuration>
</plugin>

4. 代码逻辑验证 #

你的代码本身无问题，确保FX2D常量正确引用（已继承PApplet，无需额外导入）；若使用Processing 3.x，确认fullScreen(FX2D)的调用时机符合Processing生命周期规范。

注意事项 #

• 无需导入所有Processing库，仅需core和java-fx即可，多余依赖易引发冲突
• JDK 8环境下无需添加JVM参数，依赖配置完成后即可直接运行

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