jpackage打包后模块化Java应用如何访问资源目录内容？

问题本质 #

核心矛盾是：jpackage通过--input参数将资源复制到安装目录的app文件夹后，这些资源不属于模块路径中的内容，而模块化项目的类加载器仅会加载模块Jar内部的资源，因此无法通过getResource访问到外部的资源目录。而编译和模块化Jar运行时，资源要么在类路径下，要么被打包进模块Jar，所以能正常访问。

解决方案 #

方案1：将资源打包到模块化Jar中（推荐，符合模块化规范） #

把src/main/resources下的资源直接打包进模块Jar，这样jpackage打包后资源会被包含在模块镜像中，类加载器可以正常访问。

修改打包脚本：

1. 编译后复制资源到模块目录：
   在javac编译完成后，将资源目录的内容复制到模块的classes目录下：

   # Linux/macOS
   cp -r src/main/resources/* classes/ModuleName/
   # Windows
   xcopy src\main\resources\* classes\ModuleName\ /E /I
   

2. 执行原jar打包命令：
   原命令已经打包classes/ModuleName下的所有内容，现在资源已复制到该目录，直接执行即可：

   jar                                               \
       --verbose                                     \
       --create                                      \
       --file run/executable/jar/ProjectName.jar     \
       --main-class PackageName.Main                 \
       -C classes/ModuleName .
   

3. 修改jpackage命令：
   移除--input src/main/resources参数，因为资源已经在模块Jar中：

   jpackage                                                  \
       --verbose                                             \
       --type msi                                            \
       --name ProjectName                                    \
       --install-dir davidalayachew_applications/ProjectName \
       --vendor "David Alayachew"                            \
       --win-dir-chooser                                     \
       --module-path run/executable/jar                      \
       --module ModuleName/PackageName.Main                  \
       --win-console                                         \
       --java-options "--enable-preview"                     \
       --dest run/executable/installer
   

4. 验证访问：
   原有的getResource调用（如Main.class.getClassLoader().getResource("ResourceParentFolder")）会正常返回模块内的资源路径，和Jar运行时的行为一致。

方案2：直接通过文件系统访问app目录下的资源 #

如果需要资源保留在app目录（比如允许用户修改资源），可以通过获取应用安装目录的方式直接访问文件系统：

修改Main.java代码：

package PackageName;

import java.io.File;
import java.net.URI;
import java.net.URL;

public class Main
{
    public static void main(String[] args) throws Exception
    {
        new Main();
    }

    public Main() throws Exception
    {
        // 获取模块Jar的位置
        URL jarUrl = Main.class.getProtectionDomain().getCodeSource().getLocation();
        File jarFile = new File(jarUrl.toURI());
        File appDir = jarFile.getParentFile(); // app目录，即安装目录下的app文件夹

        // 构造资源目录路径
        File resourceParentFolder = new File(appDir, "ResourceParentFolder");
        System.out.println("资源目录路径：" + resourceParentFolder.getAbsolutePath());

        // 遍历目录内容
        if (resourceParentFolder.exists() && resourceParentFolder.isDirectory()) {
            System.out.println("目录下的子项：");
            for (File item : resourceParentFolder.listFiles()) {
                System.out.println("- " + item.getName());
                if (item.isDirectory()) {
                    // 遍历子目录
                    for (File subItem : item.listFiles()) {
                        System.out.println("  - " + subItem.getName());
                    }
                }
            }
        } else {
            System.out.println("资源目录不存在");
        }
    }
}

这种方式不需要修改打包脚本，保留原有的--input src/main/resources参数即可。

为什么原方式失效？ #

• 编译和Jar运行时：资源要么在类路径（编译后运行），要么被打包进模块Jar（Jar运行），模块类加载器可以正常检索到这些资源。
• jpackage打包后：--input参数将资源复制到app目录，但这些文件不在模块路径中，模块类加载器只会加载模块内部的资源，因此getResource无法找到外部的资源目录。

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