JavaFX 21多模块Maven项目用javafx-maven-plugin报NoClassDefFoundError

核心原因 #

javafx-maven-plugin 0.0.8默认会将所有依赖（包括非JavaFX的普通Java依赖）添加到MODULE_PATH，但你的应用是非模块化的，普通Java依赖（如javax.transaction.TransactionManager、公司私有库）并非JPMS模块，无法在MODULE_PATH上被系统类加载器正确识别，从而触发NoClassDefFoundError。而IntelliJ直接运行时，是将所有依赖放入CLASSPATH，所以不存在这个问题。

解决方案 #

1. 启用runtimePathOption配置 #

你之前注释的<runtimePathOption>CLASSPATH</runtimePathOption>是关键修复项，需要正确启用它。该配置会让插件将非JavaFX依赖放到CLASSPATH，仅将JavaFX模块保留在MODULE_PATH，适配非模块化应用的类加载逻辑。修改后的插件配置如下：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>foo.bar.view.fx.Main</mainClass>
        <commandLineArgs>${programArgs}</commandLineArgs>
        <options>
            <option>jvm arg 1</option>
            <option>jvm arg 2</option>
        </options>
        <!-- 启用CLASSPATH模式适配非模块化应用 -->
        <runtimePathOption>CLASSPATH</runtimePathOption>
    </configuration>
</plugin>

2. 验证依赖传递性与Scope #

• 检查Core模块中公司私有库的依赖scope，确保是compile（默认）或runtime，避免使用provided、test等非运行时生效的scope。
• 确认父pom的dependencyManagement中是否正确引入了私有库的版本，Core模块是否正确继承并声明了该依赖。

3. 排查依赖收集情况 #

运行mvn javafx:run -X查看调试日志，搜索classpath相关条目，确认缺失的类对应的依赖是否被包含在运行时类路径中。如果未包含，检查Maven私有仓库配置（settings.xml）是否能正常拉取该私有库。

4. 清理Maven缓存 #

如果依赖存在缓存问题，执行mvn clean install -U强制更新依赖并重新构建，避免旧的缓存影响运行时依赖加载。

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