Maven项目导出可执行JAR运行时JDialog无法加载图像问题排查

你碰到的是Swing做JAR包资源加载时非常常见的两个静默故障，完全匹配“IDE里跑完全正常，打可执行JAR后图像空白”的特征：

• 你当前使用的new ImageIcon(URL)构造器，在资源位于JAR包内部时，会直接对JAR协议（jar:file:/xxx.jar!/wait.gif）的URL做异步加载，部分JDK版本下会因为类加载器权限、连接时序问题静默读取失败，全程不会抛出任何报错；但Eclipse运行时资源是直接从磁盘文件路径加载（file:/src/main/resources/wait.gif），不存在协议兼容问题，所以表现完全正常。
• Maven默认的资源导出逻辑默认开启文件过滤，会把二进制的GIF图片当作文本文件做变量替换处理，哪怕你解压JAR能看到图片文件存在，文件的二进制内容已经被改写损坏，根本无法被图像解析器读取。
• 你参考的老方案主要适配Eclipse直接导出普通Runnable JAR的场景，没有覆盖Maven打包的资源处理逻辑，同时你当前的代码没有对资源获取结果做判空校验，一旦URL获取失败，ImageIcon接收到null值就会生成空白图标，不会有任何错误提示，排查起来很容易走弯路。

1. 修改图像加载逻辑，彻底规避JAR协议兼容问题 #

不要直接把资源URL传给ImageIcon，改为通过类加载器的输入流读取资源的完整二进制内容，再基于字节数组生成图标，完全脱离JAR协议的依赖——这是JAR包内资源加载的最稳定写法，不管是普通可执行JAR，还是嵌套结构的JAR都能正常识别。
替换你现有构造函数中的资源加载逻辑即可：

public LoadingWindow() {
    this.dialog = new JDialog();
    this.dialog.setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);
    this.dialog.setTitle("Veuillez patienter");
    this.dialog.setSize(300, 200);

    JLabel imageLabel = new JLabel();
    imageLabel.setHorizontalAlignment(JLabel.CENTER);
    imageLabel.setVerticalAlignment(JLabel.CENTER);

    // 稳定的资源加载逻辑
    try (InputStream imgStream = LoadingWindow.class.getResourceAsStream("/wait.gif")) {
        if (imgStream == null) {
            throw new IllegalStateException("资源加载失败：wait.gif未在类路径根目录找到");
        }
        // 读取完整字节内容，不受JAR内部协议影响
        byte[] imgContent = imgStream.readAllBytes();
        ImageIcon icon = new ImageIcon(imgContent);
        imageLabel.setIcon(icon);
    } catch (IOException e) {
        e.printStackTrace();
    }

    this.dialog.getContentPane().add(imageLabel);
    this.dialog.setLocationRelativeTo(null);
    this.dialog.setVisible(true);
}

2. 关闭Maven资源过滤对二进制文件的破坏 #

在项目的pom.xml的build节点下增加资源配置，明确禁止对src/main/resources下的所有文件做过滤处理，避免二进制图片被改写：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <!-- 关闭资源过滤，防止二进制文件被文本化处理损坏 -->
            <filtering>false</filtering>
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
    </resources>
</build>

配置完成后重新执行Maven打包流程，可以解压JAR对比原wait.gif的文件大小、校验值，确认文件内容和源目录下的完全一致，即可排除资源损坏的问题。

• 不要把图像资源放到src/main/java目录下，Maven默认不会导出该目录下的非.class文件
• 不要使用ClassLoader.getSystemResource()的方式获取资源，可执行JAR使用自定义类加载器时，系统类加载器可能无法识别类路径下的资源
• 如果你使用Spring Boot插件打可执行JAR，保持资源路径/wait.gif不变即可，Spring Boot会自动把资源映射到类路径根目录下，不需要额外调整路径

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