升级OpenJDK 19后执行mvn test出现启动层初始化错误求助

核心原因 #

OpenJDK 11及以后版本不再内置JavaFX，需手动引入；IntelliJ会自动识别项目中的JavaFX配置，但Maven Surefire插件需要显式配置模块路径或依赖才能在测试阶段加载JavaFX模块。

具体解决方案 #

1. 确保JavaFX依赖正确引入到pom.xml #

根据你的MBP芯片类型（M系列/Intel），添加对应分类器的JavaFX依赖：

<dependencies>
    <!-- 基础图形模块 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-graphics</artifactId>
        <version>19</version>
        <classifier>mac-aarch64</classifier> <!-- M1/M2芯片用这个 -->
        <!-- Intel芯片替换为：<classifier>mac-x86_64</classifier> -->
    </dependency>
    <!-- 按需添加其他JavaFX模块，比如javafx-controls、javafx-fxml等 -->
</dependencies>

2. 配置Maven Surefire插件加载模块 #

在项目的build/plugins节点下，修改surefire插件配置，通过argLine指定模块路径和需要加载的模块：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M5</version>
            <configuration>
                <argLine>
                    --module-path "${maven.dependency.classpath}" --add-modules javafx.graphics
                    <!-- 多模块用逗号分隔，例如：javafx.graphics,javafx.controls -->
                </argLine>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 推荐：使用JavaFX Maven插件统一管理（更省心） #

该插件会自动处理平台依赖和模块路径，无需手动配置argLine：

<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <modules>
                    <module>javafx.graphics</module>
                    <!-- 按需添加其他模块 -->
                </modules>
                <platform>mac</platform>
            </configuration>
            <executions>
                <execution>
                    <id>test-javafx</id>
                    <phase>test</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

4. 多模块项目额外检查 #

• 若common模块依赖JavaFX，需确保common的pom.xml已正确引入JavaFX依赖
• 执行mvn dependency:tree查看依赖树，确认javafx-graphics已传递到core模块的依赖中
• 避免依赖环境变量：Maven进程可能无法正确读取你设置的JavaFX路径，优先用Maven依赖管理

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