Maven JavaFX模块化项目中ClassLoader加载子目录资源失败问题

核心原因 #

在模块化Maven JavaFX项目中，线程上下文类加载器（Thread.currentThread().getContextClassLoader()）的资源查找逻辑不兼容模块系统的资源访问规则。模块内的子目录资源默认处于封闭状态，除非显式配置权限，否则线程上下文类加载器无法识别这些子目录下的资源。

解决方案 #

1. 修正模块声明的资源访问权限

在module-info.java中，显式开放或导出fonts目录的资源权限，确保模块系统允许访问该路径下的资源：

module com.example.myPackage {
    requires javafx.controls;
    // 开放fonts目录资源给JavaFX（字体加载可能需要）
    opens fonts to javafx.graphics;
    // 或者导出所有模块可访问该目录资源
    exports fonts;
}

2. 使用模块内类的类加载器

替换线程上下文类加载器为当前类的类加载器，它属于模块专属加载器，能正确识别模块内的资源路径：

// 方式1：获取当前类的类加载器
ClassLoader loader = myApp.class.getClassLoader();
URL rootFile = loader.getResource("font.ttf");
URL subfolderFile = loader.getResource("fonts/font.ttf"); // 可正常加载

// 方式2：直接使用当前类的getResource方法（更简洁）
URL rootFile = myApp.class.getResource("/font.ttf"); // 斜杠表示模块资源根目录
URL subfolderFile = myApp.class.getResource("/fonts/font.ttf");

注：Class.getResource()方法中，路径开头的斜杠代表从模块的资源根目录查找；无斜杠则相对于当前类的包路径查找。

3. 兜底检查Maven资源复制配置

确认pom.xml中未限制子目录资源的复制，默认配置会自动复制所有资源，若有自定义配置需确保包含子目录：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include> <!-- 匹配所有文件及子目录 -->
            </includes>
        </resource>
    </resources>
</build>

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