Maven构建的可执行JAR静态方法加载资源失败问题求助

嘿，我一眼就看出问题出在哪了——你用File类去读取JAR里的资源，这根本行不通！JAR里的资源不是文件系统上的真实文件，而是JAR归档里的条目，ClassLoader.getResource()返回的URL是jar:协议的，不是file:协议，所以new File()肯定会找不到文件。

下面给你几个关键的修复点和正确的实现方式：

问题核心原因 #

当资源被打包进JAR后，它不再是独立的文件，而是JAR文件的一部分。ClassLoader.getResource().getFile()会返回一个类似file:/path/to/your.jar!/img/xxx.png的字符串，这个路径对File类来说是无效的，因为它不是一个真实存在的文件。

正确的资源加载方式 #

1. 直接用URL构造ImageIcon #

ImageIcon本身支持直接传入URL，这是加载JAR内图片最简单的方式：

public class ResourceLoader {
    public static ImageIcon getImageIconResource(String fileName) {
        // 优先使用当前类的类加载器，比SystemClassLoader更可靠（尤其是模块化/容器环境）
        ClassLoader classLoader = ResourceLoader.class.getClassLoader();
        // 资源路径相对于类路径根，不用加开头的/
        URL imageUrl = classLoader.getResource("img/" + fileName);
        
        if (imageUrl == null) {
            throw new RuntimeException("无法找到资源: img/" + fileName);
        }
        
        return new ImageIcon(imageUrl);
    }
}

2. 用输入流加载资源（通用方案，适用于脚本、文本等） #

如果是加载脚本、配置文件这类资源，用getResourceAsStream()获取输入流是标准做法：

public static InputStream getScriptResource(String fileName) {
    ClassLoader classLoader = ResourceLoader.class.getClassLoader();
    InputStream inputStream = classLoader.getResourceAsStream("scripts/" + fileName);
    
    if (inputStream == null) {
        throw new RuntimeException("无法找到资源: scripts/" + fileName);
    }
    
    return inputStream;
}

额外检查事项 #

• 确认JAR包结构：解压你的JAR包，看看img和scripts文件夹是不是在JAR的根目录下。Maven默认会把src/main/resources下的所有内容打包到JAR根目录，所以如果你的资源放在src/main/resources/img里，打包后路径就是/img/xxx.png，和代码里的路径对应。
• 避免使用SystemClassLoader：ClassLoader.getSystemClassLoader()可能在某些环境（比如Web容器、模块化应用）下无法正确找到JAR内的资源，用当前类的类加载器更稳定。
• Maven资源过滤注意：如果你在pom.xml里配置了<filtering>true</filtering>，要确保二进制资源（比如图片）不会被过滤，否则会损坏文件。可以在resources配置里排除图片类型：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
            <exclude>**/*.png</exclude>
            <exclude>**/*.jpg</exclude>
        </excludes>
    </resource>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>false</filtering>
        <includes>
            <include>**/*.png</include>
            <include>**/*.jpg</include>
        </includes>
    </resource>
</resources>

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