Mac OS 11.2下jpackage带--license-file构建包报hdiutil报错的修复
MacOS环境下jpackage添加
--license-file参数的构建异常排查 问题基础信息
- 运行环境:Mac OS 11.2、OpenJDK 15.0.1
- 触发条件:执行jpackage命令时传入
--license-file license.txt参数 - 异常表现:
- 主构建流程可完整走完,无提前中断提示
- 最终生成的安装包未包含指定的license文件
- 终端抛出明确错误日志:
java.io.IOException: Command [/usr/bin/hdiutil, unflatten, /Users/myproject/package-1.0.dmg] exited with 1 code
问题产生根因
- 该异常属于OpenJDK 15.0.1版本中jpackage模块的已知平台适配bug,是针对Mac平台DMG安装包构建逻辑的链路缺陷导致的。
- 具体执行逻辑问题:添加license参数后,jpackage会临时挂载刚生成的DMG镜像,将license内容写入镜像的系统配置区,完成写入后未正确同步镜像文件的系统读写权限,就直接调用系统自带的
hdiutil unflatten命令,触发系统权限拦截导致命令执行失败。后续license的正式嵌入逻辑因为这个错误被中断,最终出现构建流程看似完整走完、但安装包缺失对应文件的表象。
对应修复方案
- 临时绕开问题的方案
- 预处理license文件:将license.txt保存为UTF-8无BOM格式,移除文件内的特殊控制字符,避免hdiutil在解析license内容时触发格式校验报错
- 手动补全license嵌入流程:先执行不带
--license-file参数的jpackage基础构建,生成原始DMG安装包后,手动通过hdiutil挂载镜像、写入license相关配置、重新封装镜像,绕开jpackage自带的bug触发逻辑
- 从版本层面根治的方案
- 将OpenJDK升级至15.0.2及以上小版本,该版本已修复jpackage模块中DMG构建流程下
hdiutil unflatten调用的权限同步问题,可正常完成license文件嵌入 - 长期生产构建场景可切换至OpenJDK 17 LTS版本,该版本的jpackage模块对MacOS平台DMG、PKG安装包的构建逻辑做了完整兼容,不存在license嵌入相关的已知适配问题
- 将OpenJDK升级至15.0.2及以上小版本,该版本已修复jpackage模块中DMG构建流程下
内容的提问来源于stack exchange,提问作者Hollow.Quincy
相关产品推荐
相关产品推荐

