IntelliJ Maven项目无法读取resources子文件夹内图片的技术咨询

我之前也碰到过这个一模一样的问题，其实核心是JavaFX加载资源的路径规范和Maven资源打包的小细节没处理对，咱们一步步来搞定：

1. 用Class.getResource()替代直接路径字符串 #

JavaFX的Image构造函数直接传相对字符串时，对于子目录资源很容易出现路径定位错误——尤其是Maven打包后，所有resources下的资源都会被放到classpath根目录下。正确的姿势是通过类的getResource()方法获取资源的URL，再传给Image：

// 正确加载resources/images/logo.png的写法
URL imageUrl = getClass().getResource("/images/logo.png");
if (imageUrl == null) {
    throw new IllegalArgumentException("找不到图片资源：/images/logo.png");
}
var img = new Image(imageUrl.toExternalForm());

注意路径开头的斜杠/，它表示从classpath的根目录开始查找，这样不管你的类在哪个包下，都能准确定位到resources子目录里的资源。

而你之前写的new Image("images/logo.png")没有指定根路径，JavaFX会默认从当前类所在的包目录下去找，自然找不到resources根下的images文件夹。

2. 确保Maven正确打包子目录资源 #

默认Maven会把src/main/resources下的所有文件打包到classpath，但如果你的pom.xml有自定义资源配置，可能会漏掉子目录。可以在pom里显式配置资源包含规则，确保所有子目录的资源都被打包：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <!-- 包含所有子目录和文件 -->
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
    </resources>
</build>

3. 验证资源是否被正确复制 #

可以去项目的target/classes目录下检查，应该能看到images文件夹和里面的logo.png文件。如果没有，说明资源没被Maven正确复制：

• 检查IntelliJ的项目配置：File -> Project Structure -> Modules -> 你的模块 -> Paths，确认Resource Output Directory指向target/classes
• 执行mvn clean compile重新编译，强制Maven复制资源

你遇到的Invalid URL or resource not found错误，本质就是资源路径没找到，按照上面的步骤调整后应该就能解决问题，既保持了清晰的文件结构，又能正确加载资源。

内容的提问来源于stack exchange，提问作者SashimiDélicieux