Maven打包JavaFX可执行Jar报找不到主类或无main清单属性求助

问题根因 #

1. OpenJDK 8 自带的 JavaFX 运行时（jfxrt.jar）默认不在标准类路径中，NetBeans 运行时会自动加载该包，但命令行执行 Maven 命令时不会自动识别，因此会出现javafx包不存在的报错
2. 你当前配置中assembly插件的classpathPrefix=lib/和jar-with-dependencies的打包逻辑冲突：fat jar将所有依赖打入同一jar包，不需要额外指定lib类路径前缀，反而会导致类路径异常
3. 高版本shade-plugin和NetBeans 8.2内置的Maven版本兼容性差，会出现构件处理报错

正确配置方案 #

第一步：引入JavaFX依赖 #

在pom的dependencies节点下加入JavaFX依赖配置，让命令行Maven可以识别到本地JDK自带的jfxrt.jar：

<dependencies>
    <!-- JavaFX 8 依赖适配 -->
    <dependency>
        <groupId>com.oracle</groupId>
        <artifactId>javafx</artifactId>
        <version>8.0</version>
        <scope>system</scope>
        <systemPath>${java.home}/lib/ext/jfxrt.jar</systemPath>
    </dependency>
    <!-- 此处保留你原有其他依赖 -->
</dependencies>

第二步：配置maven-shade-plugin #

删除pom中所有maven-assembly-plugin的配置，使用你之前正常工作的2.3版本shade插件，新增签名过滤和服务资源转换配置解决依赖冲突：

<build>
    <finalName>Kvn</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>2.3.2</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>2.3</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>com.qohelet.kvn.MainApp</mainClass>
                            </transformer>
                            <!-- 解决服务配置文件合并冲突 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                        </transformers>
                        <!-- 过滤第三方依赖的签名文件，避免类加载校验失败 -->
                        <filters>
                            <filter>
                                <artifact>*:*</artifact>
                                <excludes>
                                    <exclude>META-INF/*.SF</exclude>
                                    <exclude>META-INF/*.DSA</exclude>
                                    <exclude>META-INF/*.RSA</exclude>
                                </excludes>
                            </filter>
                        </filters>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

第三步：执行打包命令 #

使用NetBeans内置的Maven执行打包，和你日常运行的环境保持一致，避免版本差异：

cd /home/qohelet/Projekte/Kvn
JAVA_HOME=/home/qohelet/jdk1.8.0_111 /home/qohelet/netbeans-8.2/java/maven/bin/mvn clean package

打包完成后target目录会生成20MB左右的Kvn.jar，直接执行java -jar Kvn.jar即可启动。

异常排查 #

如果仍然报错可按以下步骤验证：

• 解压生成的jar包，确认META-INF/MANIFEST.MF中存在Main-Class: com.qohelet.kvn.MainApp配置，且行尾无多余空格
• 确认执行java命令的版本为1.8.0_111，高版本JDK默认不带JavaFX会启动失败
• 执行java -cp Kvn.jar com.qohelet.kvn.MainApp验证能否启动，可启动则为Manifest配置问题，不可启动则检查类编译版本是否匹配

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