MacOS下jpackage构建的Java/Swing教育应用启动失败求助

我用Java/Swing开发了一款教育类应用，打算发布到MacOS平台，采用JDK 16.0.2的jpackage命令行工具构建安装包/启动器。构建时开启verbose模式无报错，最终提示“Succeeded in building Mac DMG Package package”。但安装完成后，双击Applications文件夹内的DataflowGeometry2D.app，Dock中图标出现并跳动，却从未进入应用main()方法，没有任何错误反馈。查看Activity Monitor发现，双击后生成约30个进程，1-2秒内全部终止。

开发环境：

• 2021款Intel芯片iMac，运行BigSur系统
• 使用Eclipse for Java SE (2001-3)
• 导出的可运行jar包双击可正常启动
• 构建路径使用JRE 16.0.2

附使用的jpackage命令：

jpackage --input ~/git/DataflowGeometry/AlgoGeom_V2 --main-jar ~/DFG2D_MacOS_Manufacturing/AppJAR/DFG2D_Mac_J1602.jar --main-class ~/git/DataflowGeometry/AlgoGeom_V2/src/workspace2D/DataflowGeometry2D --dest ~/DFG2D_MacOS_Manufacturing/MacOSInstallers/DFG2D_Mac_J1602 --app-version "1.0.0"  --copyright "All rights reserved Spatial Thoughtware 2022" --name DataflowGeometry2D --description "21st Century Geometry Problem-Solving Workspace" --vendor "Spatial Thoughtware" --input ~/git/DataflowGeometry/AlgoGeom_V2/src/DFG2D_AppData --java-options "-d64 -splash:$APPDIR/SplashScreenDFG2D.png" --verbose

1. 获取启动时的详细日志 #

直接通过终端运行app启动器，捕获控制台输出：

• 执行命令：/Applications/DataflowGeometry2D.app/Contents/MacOS/DataflowGeometry2D，启动过程中的错误、类加载信息会直接打印在终端。
• 或者添加Java verbose参数：open -a /Applications/DataflowGeometry2D.app --args -verbose:class -verbose:jni，查看更详细的启动流程。

另外可通过系统日志排查：

• 打开「控制台」应用，搜索DataflowGeometry2D，过滤相关系统日志，可能找到启动失败的底层原因。

2. 修正jpackage参数错误 #

从提供的命令看，存在几个明显问题：

• 重复的--input参数：jpackage只会生效最后一次指定的输入路径，第一个路径下的依赖资源会被忽略。需合并输入路径，或改用--resource-dir指定额外资源目录。
• --main-class格式错误：主类需填写全限定类名（如workspace2D.DataflowGeometry2D），而非本地文件路径，否则启动器无法定位入口类。
• --java-options中的splash路径：先移除-splash:$APPDIR/SplashScreenDFG2D.png参数，测试应用能否启动，排除图片路径解析问题。

3. 检查App包内的文件结构 #

右键点击DataflowGeometry2D.app选择「显示包内容」，验证：

• Contents/Resources/app/下是否包含主jar包DFG2D_Mac_J1602.jar及所有依赖资源。
• Contents/Info.plist中JavaMainClass字段是否为正确的全限定类名。
• Contents/MacOS/下的启动器是否有执行权限（可通过chmod +x /Applications/DataflowGeometry2D.app/Contents/MacOS/DataflowGeometry2D修复）。

4. 构建最简版本测试 #

先构建无额外参数的最简安装包，定位问题来源：

jpackage --input ~/DFG2D_MacOS_Manufacturing/AppJAR --main-jar DFG2D_Mac_J1602.jar --main-class workspace2D.DataflowGeometry2D --dest ~/test_installer --name DataflowGeometry2D --verbose

若最简版本能正常启动，再逐步添加资源目录、Java参数等配置，找到导致启动失败的具体参数。

5. 验证内置JRE完整性 #

jpackage默认会打包JRE到App包内，检查Contents/PlugIns/下是否存在完整的JRE目录，确认其适配Intel x86_64架构（JDK16.0.2的Intel版本无此问题）。

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