Eclipse构建Maven可执行Jar后getResource()无法找到资源

核心问题根源 #

Maven默认会将src/main/resources下的资源直接打包到Jar的根目录（对应IDE运行时的target/classes目录），但你的Jar中资源被嵌套到了resources/Images下，导致getClass().getResource()无法匹配到正确路径，最终抛出NullPointerException。

具体解决步骤 #

1. 修正Maven资源打包配置 #

打开pom.xml，检查是否存在自定义的<resources>配置。如果有类似以下错误配置，会导致资源被嵌套打包：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <targetPath>resources</targetPath> <!-- 这行是问题关键 -->
        </resource>
    </resources>
</build>

解决方式：删除<targetPath>resources</targetPath>，或改为<targetPath>.</targetPath>，确保资源直接输出到类路径根目录（Jar根目录）。

2. 规范getResource()路径写法 #

无论IDE运行还是Jar运行，资源路径都要基于类路径根目录：

• 必须以斜杠/开头，代表从类路径根开始查找
• 路径直接写/Images/xxx，不要加resources/前缀

示例代码：

// 正确写法
URL logoUrl = getClass().getResource("/Images/logo.png");
if (logoUrl == null) {
    throw new RuntimeException("未找到资源：/Images/logo.png");
}
InputStream iconStream = getClass().getResourceAsStream("/Images/icon.png");

3. 清理Eclipse缓存并重新构建 #

Eclipse的Maven缓存可能导致资源处理异常，执行以下操作：

• 右键项目 → Maven → Clean
• 右键项目 → Maven → Update Project（勾选Force Update of Snapshots/Releases）
• 重新执行mvn package打包，然后用解压工具查看Jar内部结构，确认Images目录直接在Jar根目录下，而非嵌套在resources中。

4. 确认Eclipse资源目录配置 #

检查Eclipse是否正确识别src/main/resources为资源目录：

• 右键项目 → Properties → Java Build Path → Source标签
• 确保src/main/resources的Output folder设置为target/classes，且未被标记为Excluded。

附用户提供的相关信息 #

报错信息 #

Exception in thread "main" java.lang.NullPointerException: Cannot invoke "java.net.URL.openStream()" because the return value of "java.lang.Class.getResource(String)" is null
    at com.yourpackage.ImageLoader.loadLogo(ImageLoader.java:22)
    at com.yourpackage.Main.main(Main.java:18)

问题代码示例 #

public class ImageLoader {
    public void loadLogo() {
        // 错误写法：未加根路径斜杠，或路径包含resources前缀
        URL logoUrl = getClass().getResource("Images/logo.png");
        Image logo = ImageIO.read(logoUrl.openStream()); // 此处抛出NPE
    }
}

环境版本 #

• Eclipse: 2023-09 (4.29.0)
• Maven: 3.8.6
• JDK: 17
• 原开发IDE: NetBeans 15

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