NetBeans中Maven构建的JavaFX可执行Jar运行报错排查

AI 小北

2026-8-30

问题原因

你碰到的两个报错核心是JavaFX项目打包配置错误，以及IDE运行逻辑和独立Jar运行逻辑的差异：

NetBeans内运行正常是因为IDE自动帮你配置了JavaFX模块路径、Maven依赖类路径，这些配置不会自动同步到独立Jar包的运行逻辑里。
第一个No main manifest attribute报错，是因为默认Maven构建生成的Jar包不会写入主类信息，也不会包含第三方依赖内容。
第二个NoClassDefFoundError: javafx/application/Application报错有两个诱因：
- 你添加的低版本maven-jar-plugin只会在清单里写入主类路径，不会把依赖的JavaFX类包打进Jar，也不会配置Java 11+版本需要的JavaFX模块引用，运行时JVM找不到JavaFX核心类就会报错。
- 你通过NetBeans重命名项目时，IDE只会修改代码内的引用，不会自动同步pom.xml里硬编码的主类路径，如果重构时修改了包名，配置里旧的com.mycompany.mavenproject2.App路径就会失效。

解决步骤

按以下顺序修改配置，重新构建即可：

第一步：确认主类全限定名
打开src/main/java下的App.java文件，看顶部package关键字后面的路径：如果重构时没有修改包结构，就还是com.mycompany.mavenproject2.App；如果包名随项目名改了，就以文件里实际声明的包名为准。
第二步：替换打包插件
把你pom里原来的maven-jar-plugin配置删掉，换成maven-shade-plugin来构建包含所有依赖的可执行Fat Jar，配置如下，注意把<mainClass>标签里的内容换成你上一步确认的实际主类路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>替换成你的实际主类全限定名</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

第三步：同步修改javafx-maven-plugin配置里的<mainClass>值，和你实际的主类路径保持一致，保证IDE内运行不受影响。
第四步：清理后重新构建
在项目根目录执行以下Maven命令，或者在NetBeans里右键项目选择「清理并构建」：
```
mvn clean package
```
第五步：验证运行
构建完成后，target目录下会生成一个带-shaded.jar后缀的文件，直接双击或者用java -jar 文件名.jar命令即可正常运行，不需要额外配置JavaFX环境。

注意事项

不要用版本过低的Maven插件，2.x版本的maven-jar-plugin对Java 11及以上版本的模块化项目支持存在缺陷，很容易出现类找不到的问题。
如果不想打包含所有依赖的Fat Jar，也可以保留原有maven-jar-plugin配置，但运行时必须手动在命令中指定JavaFX模块路径，操作繁琐不推荐普通场景使用。
每次修改pom配置后一定要执行clean操作清空旧的target目录，避免残留的旧构建文件导致配置不生效。

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