JavaFX项目IDE运行图标正常，Jar打包后图标不显示问题排查

核心原因 #

IDE运行时可直接访问文件系统路径，但打包成Jar后，资源被嵌入Jar内部，必须通过类加载器路径引用，而非普通文件路径。

具体解决步骤 #

1. 修正CSS中的资源引用 #

将CSS中图标路径的写法从相对路径改为类路径根路径（开头加斜杠）：

/* 原写法（仅IDE中有效） */
.new-game-button {
    -fx-background-image: url("images/New_Game.png");
}

/* 修改后（Jar内有效） */
.new-game-button {
    -fx-background-image: url("/images/New_Game.png");
}

2. 修正FXML中的图标引用 #

如果图标是在FXML中直接定义的，同样将资源路径改为类路径根路径：

<Button fx:id="newGameButton" styleClass="new-game-button">
    <!-- 或者直接在ImageView中指定正确路径 -->
    <graphic>
        <ImageView>
            <image>
                <Image url="/images/New_Game.png" />
            </image>
        </ImageView>
    </graphic>
</Button>

3. 确保Maven打包时正确包含资源 #

检查pom.xml的资源配置，确保images文件夹被正确打包进Jar：

<build>
    <resources>
        <!-- 包含src/main/resources下的所有资源 -->
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
        <!-- 如果images文件夹在项目根目录，添加此配置 -->
        <resource>
            <directory>images</directory>
            <includes>
                <include>**/*.png</include>
            </includes>
        </resource>
    </resources>
</build>

4. 代码中加载图标的正确方式 #

如果是在Controller中动态设置图标，必须使用类加载器读取资源，而非文件路径：

// 错误写法（仅IDE中有效）
// Image image = new Image("file:images/New_Game.png");

// 正确写法（Jar内有效）
Image image = new Image(getClass().getResourceAsStream("/images/New_Game.png"));
newGameButton.setGraphic(new ImageView(image));

验证步骤 #

1. 重新执行Maven打包命令：mvn clean package
2. 解压生成的Jar文件，确认images文件夹位于Jar顶层，且包含目标图标
3. 将Jar放入指定的"app environment"目录运行，检查图标是否显示

关于AbsoluteLayout警告 #

该警告是依赖缺失提示，不影响资源加载逻辑，若按钮功能正常可暂时忽略；若后续出现布局问题，需补充对应依赖到pom.xml中。

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