Java AWT SystemTray鼠标事件不触发问题排查

你的问题核心在于混淆了系统托盘图标和通知气泡的事件触发逻辑，另外还有几个容易忽略的细节问题，我来逐一拆解并给出修复方案：

1. 事件监听对象搞反了 #

你给TrayIcon添加的是MouseListener，但这个监听器只负责响应系统托盘里的图标的鼠标操作（比如点击托盘栏上的小图标）。而你通过displayMessage弹出的通知气泡，当用户点击它时，触发的是ActionListener事件，不是鼠标事件！

这就是为什么你点击气泡完全没反应——代码里根本没处理这个关键事件。

2. 图标加载可能静默失败 #

Toolkit.createImage方法加载图片失败时不会抛出异常，只会默默返回一个无效的Image对象，导致托盘图标显示异常（甚至完全不显示），这时候点击自然也不会触发任何事件。建议添加图片加载的校验逻辑，确保图标正常加载。

修复后的完整代码 #

我把你的代码修改成同时支持托盘图标点击和通知气泡点击的版本，还优化了代码结构：

import java.awt.*;
import java.awt.event.*;
import java.net.*;

public class NotificationUtils { 
    private static SystemTray tray; 
    private static TrayIcon trayIcon; 

    public static void showNotification(String message, final String url) throws AWTException { 
        if(tray == null) { 
            tray = SystemTray.getSystemTray(); 
            Image image = Toolkit.getDefaultToolkit().createImage("icon.png");
            
            // 校验图标是否加载成功，避免无效图标导致的交互问题
            MediaTracker tracker = new MediaTracker(new JPanel());
            tracker.addImage(image, 0);
            try {
                tracker.waitForAll();
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            if (image.getWidth(null) == -1) {
                System.err.println("图标加载失败，将使用默认图标");
                image = Toolkit.getDefaultToolkit().getImage(NotificationUtils.class.getResource("/default-icon.png"));
            }

            trayIcon = new TrayIcon(image, "Tray Demo"); 

            // 监听托盘图标的鼠标点击（比如点击托盘栏里的图标）
            trayIcon.addMouseListener(new MouseAdapter() { // 用MouseAdapter可以只实现需要的方法，简化代码
                @Override 
                public void mouseClicked(MouseEvent e) { 
                    openTargetUrl(url);
                } 
            }); 

            // 监听通知气泡的点击！这才是你需要处理的通知交互事件
            trayIcon.addActionListener(new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent e) {
                    openTargetUrl(url);
                }
            });

            trayIcon.setImageAutoSize(true); 
            trayIcon.setToolTip("New Notification"); 
            tray.add(trayIcon); 
        } 
        trayIcon.displayMessage("Atanmamış Bildirim Var", message, TrayIcon.MessageType.INFO); 
    }

    // 把打开URL的逻辑抽成公共方法，避免重复代码
    private static void openTargetUrl(String url) {
        System.out.println("触发打开URL事件");
        // 提前校验Desktop是否支持浏览操作
        if (!Desktop.getDesktop().isSupported(Desktop.Action.BROWSE)) {
            System.err.println("当前环境不支持打开浏览器");
            return;
        }
        try { 
            Desktop.getDesktop().browse(new URL(url).toURI()); 
        } catch (URISyntaxException | IOException ex) { 
            ex.printStackTrace(); 
        }
    }
}

额外注意事项 #

• 控制台应用要确保AWT事件线程正常运行，建议在应用启动时通过EventQueue.invokeLater(() -> {})来初始化托盘相关逻辑，避免线程冲突。
• 不同操作系统对SystemTray的支持有差异：Linux的部分桌面环境（如GNOME）可能需要额外配置才能显示托盘图标；Windows和macOS的支持相对完善。
• 如果URL是相对路径或特殊格式，建议提前做合法性校验，避免转换URI时抛出异常。

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