使用jpackage打包JavaFX项目遇java.io.IOException错误求助

问题重现 #

执行以下jpackage命令时触发java.io.IOException，错误根源是自动生成的图标ID包含非法字符（以问号开头），违反WiX标识符规则：

jpackage -t exe --name demobasit --description "deneme aciklamasi" --app-version 1.0 --input out/artifacts/demobasit_jar --dest C:\Users\Yusuf\Documents\yazilimim --icon src\sample\soundforge.ico --main-jar demobasit.jar --module-path "C:\Program Files\Java\JavaFX\openjfx-20.0.2_windows-x64_bin-sdk\javafx-sdk-20.0.2\lib" --add-modules javafx.controls,javafx.media,javafx.fxml --win-shortcut --win-menu

错误提示：

Command [candle.exe, -nologo, C:\Users\Yusuf\AppData\Local\Temp\jdk.jpackage12319285200917365654\config\bundle.wxf, -ext, WixUtilExtension, -arch, x64, -out, C:\Users\Yusuf\AppData\Local\Temp\jdk.jpackage12319285200917365654\wixobj\bundle.wixobj] in C:\Users\Yusuf\AppData\Local\Temp\jdk.jpackage12319285200917365654\images\win-msi.image\demobasit exited with 14 code

启用--verbose后确认：自动生成的图标ID?con_313380542不符合WiX规则（需以字母/下划线开头，仅含ASCII字母、数字、下划线、句点）。

排查与解决步骤 #

1. 修改图标文件名与路径 #

• 确保图标文件名仅包含ASCII字母、数字、下划线或句点，避免空格、非ASCII特殊字符。将soundforge.ico重命名为app_icon.ico，路径调整为无特殊字符的位置，比如src\sample\app_icon.ico，然后更新jpackage命令的--icon参数：

--icon src\sample\app_icon.ico

2. 手动指定WiX图标ID（自定义jpackage模板） #

jpackage默认自动生成图标ID，若问题仍存在，可通过自定义WiX模板强制指定合法ID：

1. 生成默认WiX模板：执行jpackage --win-template-path .\wix-templates（当前目录会生成模板文件）
2. 找到模板中的图标定义部分，将自动生成的ID替换为合法值，比如AppIcon_123
3. 打包时指定自定义模板：

jpackage --win-template-path .\wix-templates [其他原有参数]

3. 验证WiX版本兼容性 #

• 确保WiX版本与JDK版本匹配：JDK 17+推荐使用WiX 3.11或4.x版本，避免过旧版本。
• 检查WiX是否已添加到系统环境变量PATH，执行candle.exe -version确认可正常调用。

4. 清理jpackage临时文件 #

• 删除C:\Users\Yusuf\AppData\Local\Temp下所有以jdk.jpackage开头的临时目录，避免缓存的错误配置干扰打包。

5. 简化jpackage参数排查 #

• 先移除--win-shortcut和--win-menu参数，尝试基础打包，确认是否成功。若成功，再逐步添加参数定位问题。
• 将--description中的非ASCII字符替换为纯ASCII内容，比如--description "Demo Application"

6. 验证图标文件合法性 #

• 使用图标编辑工具（如IconWorkshop）检查soundforge.ico是否为标准Windows图标格式（支持32x32、64x64等尺寸，无损坏），若有问题重新导出图标。

7. 排查依赖配置 #

• 确认JavaFX模块路径正确，--add-modules指定的所有模块（javafx.controls,javafx.media,javafx.fxml）都存在于--module-path目录下。
• 检查MySQL驱动是否已包含在--input目录的jar包中，避免依赖缺失导致间接错误。

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