如何构建带托盘图标的Jar文件？本地正常打包后图标失效

算力阿峰

2026-7-1

系统托盘图标打包Jar后无法显示的问题解决

问题出在资源文件的加载方式上：

本地运行时，src/main/resources/bsx.png是文件系统中的实际路径，所以Toolkit.getImage()能正常读取到文件；
打包成Jar后，资源文件是嵌入在Jar包内部的，不再是文件系统里的独立文件，用普通的相对路径根本找不到，导致图标加载失败，显示默认异常图标。

正确的资源加载方式

改用类加载器访问Jar内部的资源，类加载器可以直接定位到Jar包中的资源文件。修改后的代码如下：

// 通过类加载器获取资源URL，路径以/开头表示从类路径根目录查找
URL imgUrl = getClass().getResource("/bsx.png");
if (imgUrl == null) {
    throw new RuntimeException("无法找到图标资源：bsx.png");
}
Image img = Toolkit.getDefaultToolkit().getImage(imgUrl);
TrayIcon trayIcon = new TrayIcon(img, "Loop Driver", popupMenu);

trayIcon.setImageAutoSize(true);
trayIcon.setPopupMenu(popupMenu);

try {
    systemTray.add(trayIcon);
} catch (AWTException e) {
    throw new RuntimeException(e.getMessage());
}

额外注意事项

静态方法中的调整：如果这段代码在静态方法里，需要用你的类名.class.getResource("/bsx.png")代替getClass().getResource()
更可靠的加载方式：可以用ImageIO.read()替代Toolkit.getImage()，它会立即加载资源并抛出明确的异常，方便调试资源缺失问题：

URL imgUrl = getClass().getResource("/bsx.png");
if (imgUrl == null) {
    throw new RuntimeException("资源文件 bsx.png 未被正确打包到Jar中");
}
BufferedImage img = ImageIO.read(imgUrl);
TrayIcon trayIcon = new TrayIcon(img, "Loop Driver", popupMenu);