如何用Java 19的jpackage将程序注册为Windows服务（遇NPE报错）

service-installer.exe的获取路径 #

service-installer.exe是JDK自带的资源文件，默认位于你的JDK安装目录下的lib/jpackage/windows路径中，例如：

C:\Program Files\Java\jdk-17.0.8\lib\jpackage\windows\service-installer.exe

如果你的JDK目录中没有这个文件，说明你使用的JDK版本不支持--launcher-as-service参数（该参数从JDK 16开始引入），或者安装的是精简版JDK。此时需要下载完整的官方JDK安装包（建议选择JDK 17+ LTS版本），重新安装后即可找到该文件。

最佳解决步骤 #

1. 验证JDK版本与文件完整性

   • 确认你的JDK版本在16及以上，优先使用LTS版本（如17、21）。
   • 检查JDK安装目录的lib/jpackage/windows下是否存在service-installer.exe，若缺失则重新安装完整JDK。

2. 确保jpackage能读取到资源文件
   如果JDK目录正确但jpackage仍无法找到该文件，可以手动指定资源目录：

   • 创建一个本地文件夹（如./jpackage-resources），将service-installer.exe复制到该文件夹中。
   • 修改jpackage命令，添加--resource-dir参数：

     jpackage --type msi -i . --main-jar my-app.jar --name my-app --app-version "1.0.00" --dest . --win-shortcut --win-menu --launcher-as-service --resource-dir ./jpackage-resources
     

3. 检查应用与参数适配性

   • 确保你的Java应用适合作为Windows服务运行：服务在后台无GUI环境执行，若应用包含GUI界面，可能无法正常启动，建议改为控制台应用或适配服务运行模式。
   • 确认WiX Toolset已正确安装并添加到系统环境变量中，jpackage需要调用WiX的工具链生成MSI包。

4. 排查命令参数问题
   移除不必要的参数测试，比如先去掉--win-shortcut和--win-menu，仅保留核心参数生成MSI，确认服务安装功能正常后再添加额外参数。

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