JavaFX项目部署：资源访问异常及标准处理方法问询

问题根源 #

你遇到的核心问题是资源加载路径依赖当前工作目录——IDE中或Jar与资源同文件夹时，当前工作目录就是资源所在目录，能正常读取；但将Jar设为桌面快捷方式启动时，当前工作目录会变成系统桌面路径，导致无法定位原资源文件。

标准解决方法 #

方法1：将资源打包进Jar（推荐单文件部署） #

这是Java应用部署的标准做法，无需额外管理外部资源：

• 把所有资源（图片、配置文件等）放到项目的src/main/resources目录下，IDE或构建工具（Maven/Gradle）会自动将该目录内容打包到Jar的根路径中。
• 使用类加载器加载资源，而非文件路径，示例代码：

// 加载Jar内的图片资源
Image appLogo = new Image(getClass().getResourceAsStream("/images/logo.png"));
// 加载Jar内的配置文件
InputStream configInput = getClass().getResourceAsStream("/config/app.properties");

• 注意：路径开头的/代表Jar根目录，不要用相对路径；可解压Jar文件确认资源是否已被正确打包。

方法2：固定外部资源路径（适合需修改资源的场景） #

如果必须将资源放在Jar外部，可约定固定的资源目录结构：

• 在Jar所在目录创建resources文件夹，将所有资源放入其中。
• 通过代码动态获取Jar的实际路径，再拼接资源路径，示例代码：

// 获取Jar所在的绝对路径
String jarDir = new File(Main.class.getProtectionDomain().getCodeSource().getLocation().toURI()).getParent();
// 拼接外部资源路径
File imageFile = new File(jarDir + "/resources/images/logo.png");
Image appLogo = new Image(imageFile.toURI().toString());

• 这种方式下，只需将Jar和resources文件夹一起复制到任意位置，桌面快捷方式指向Jar即可正常加载资源。

额外部署技巧 #

• 用Maven/Gradle构建时，确保src/main/resources被配置为资源目录（默认已支持），避免资源遗漏。
• 创建桌面快捷方式时，可将快捷方式的「起始位置」设置为Jar所在目录（Windows右键快捷方式→属性→起始位置；Mac创建快捷方式时指定工作目录），兼容相对路径加载，但仍推荐前两种方法更可靠。

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