jpackage打包JavaFX为exe后报第三方类找不到错误求解

你的判断完全准确，报错核心原因就是jpackage没有把Spire.Doc/Aspose.Words这类第三方依赖打进最终安装包。
jpackage打包非模块化Java项目时，不会自动拉取你在IDE里配置的、或是Maven/Gradle引入的依赖，只会把--input参数指定目录下的所有文件纳入打包范围。你之前的输入目录里只有自己项目编译出的主jar，缺了第三方依赖包，运行时自然找不到类。至于Eclipse里运行、直接执行jar包正常，是因为IDE运行时自动配置了依赖类路径，如果你之前跑的是fat jar，也是打包阶段已经把依赖塞进了单个jar里，和jpackage的打包逻辑完全不同。

1. 准备完整的打包输入目录 #

先建一个空目录（比如命名为package-input），把你自己项目编译出的主jar、所有第三方依赖jar全部放进去：

• 如果你用Maven管理项目，执行以下命令可以自动把所有依赖导出到指定目录：

mvn dependency:copy-dependencies -DoutputDirectory=./package-input

执行完把项目编译生成的主jar也复制到./package-input目录下即可。

• 如果你用Gradle管理项目，先在build.gradle里添加依赖复制任务：

task copyDependencies(type: Copy) {
    from configurations.runtimeClasspath
    into './package-input'
}

执行gradle copyDependencies导出依赖后，同样把主jar复制到该目录。

• 如果你是手动导入jar包没有用构建工具，直接把项目lib目录下的所有第三方jar、主jar一起拷贝到这个输入目录就行。

2. 修正jpackage打包命令 #

你之前的命令存在重复写--add-modules参数、输入目录依赖不全的问题，修正后参考如下：

jpackage ^
--module-path "本地JavaFX jmods文件夹的绝对路径" ^
--add-modules javafx.controls,javafx.fxml ^
--input "./package-input" ^
--name 你的应用名称 ^
--main-jar 你的主jar文件名.jar ^
--main-class doc.docMain ^
--win-shortcut ^
--win-console

参数注意事项：

• 多个JavaFX模块用逗号分隔，写在同一个--add-modules参数后即可，不需要重复声明参数
• 如果路径包含空格、中文字符，必须用英文双引号把整个路径包裹起来
• 不要把Spring Boot格式的可执行fat jar直接当主jar传给jpackage，它的嵌套jar结构jpackage无法识别，必须把所有依赖拆成独立jar放在输入目录

3. 打包前预校验（可选但推荐） #

在执行jpackage之前，先进入package-input目录，执行以下命令验证类路径配置正确：

java --module-path "本地JavaFX lib文件夹路径" --add-modules javafx.controls,javafx.fxml -jar 你的主jar文件名.jar

如果这条命令能正常启动应用、点击按钮可以正常生成Word文档，再执行jpackage打包就不会出现类找不到的错误。

• 如果使用的是商业版Spire.Doc/Aspose.Words，记得把授权校验相关的jar、配套的dll动态链接库文件也一起放到输入目录，避免打包后出现授权验证失败的问题
• 打包用的JDK架构（32位/64位）要和依赖包的架构匹配，不然32位系统跑64位打包的程序也会报类找不到或者加载失败的错误

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