JavaFX预加载器报错：期望静态方法ImageStorage.addImageLoaderFactory

1. 替换过时的SVG加载库 #

错误核心是de.codecentric.centerdevice.javafxsvg库与JavaFX 21的内部API不兼容——JavaFX 21修改了com.sun.javafx.iio.ImageStorage.addImageLoaderFactory的方法定义，而该库仍在调用旧的静态方法签名。

JavaFX 17及以上版本原生支持SVG文件加载，无需依赖第三方SVG库。你可以直接移除javafxsvg相关依赖，改用JavaFX原生API加载SVG：

// 替换原有的SVG加载代码
Image svgImage = new Image("path/to/your/file.svg");
ImageView imageView = new ImageView(svgImage);

如果必须使用第三方SVG库，需切换到适配JavaFX 21的维护活跃库（例如org.jfxtras:svg-image-viewer），避免使用已停止更新的javafxsvg。

2. 调整GraalVM Agent启动参数 #

在确保依赖兼容后，重新生成Native Image配置时精简参数：

java -agentlib:native-image-agent=config-output-dir="META-INF/native-image" \
--module-path %MODULE_PATH% \
--add-modules ALL-MODULE-PATH \
--add-exports javafx.graphics/com.sun.javafx.application=ALL-UNNAMED \
-cp "classes;lib/*" app.Main

• 移除冗余的ALL-DEFAULT和ALL-SYSTEM模块，减少模块冲突风险；
• 仅保留必要的--add-exports参数，避免过度暴露内部API。

3. 构建原生镜像 #

生成配置后，执行以下命令构建GraalVM原生镜像：

native-image --module-path %MODULE_PATH% \
--add-modules ALL-MODULE-PATH \
--add-exports javafx.graphics/com.sun.javafx.application=ALL-UNNAMED \
-cp "classes;lib/*" \
-H:ConfigurationFileDirectories=META-INF/native-image \
app.Main

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