Java AWT托盘图标显示通知时为何吞掉鼠标事件？

阿华AIGC实验室

2026-5-27

Windows 10下Java 8 AWT托盘图标通知期间丢失首次点击事件的问题分析与解决

这个问题是Windows系统和Java AWT托盘组件交互时的典型系统级行为问题，不少Java开发者在Windows环境下用AWT托盘都会碰到类似的坑。

问题根源

当你调用TrayIcon.displayMessage()弹出系统通知气泡时，Windows会自动把这个通知气泡设为当前焦点窗口。此时点击托盘图标，系统首先要处理「焦点从通知气泡转移到托盘区域」的系统级操作，这就直接吞掉了第一次点击的mousePressed和mouseClicked事件——系统认为你这次点击是用来切换焦点区域，而非触发托盘图标的交互事件。只有当通知气泡被手动关闭（或自动消失）后，焦点回归正常状态，托盘图标才能完整捕获所有鼠标事件。

复现验证

你的测试结果完全匹配这个逻辑：

不弹出通知时，双击托盘图标会触发完整的6个事件：

Mouse Pressed
Mouse Released
Mouse Clicked
Mouse Pressed
Mouse Released
Mouse Clicked

弹出通知后首次双击，系统吞掉了第一次的Pressed和Clicked，仅留下：
```
Mouse Released
Mouse Pressed
Mouse Released
Mouse Clicked
```

可行解决方案

针对这个问题，有几种实用的处理方式：

1. 延迟弹出通知

给通知弹出加一段短暂延迟，让托盘图标先完成初始化并获取焦点，避免系统焦点抢占。可以用SwingUtilities.invokeLater或Timer实现：

// 替换原有的displayMessage调用
SwingUtilities.invokeLater(() -> {
    try {
        Thread.sleep(300); // 延迟300毫秒，给系统足够时间完成托盘初始化
        trayIcon.displayMessage("title", "message", TrayIcon.MessageType.NONE);
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
});

不过这种方式依赖系统响应速度，稳定性并非100%。

2. 自定义通知替代系统通知

放弃使用AWT自带的displayMessage，自己用Swing实现轻量级通知窗口。这样能完全控制窗口的焦点和事件逻辑，不会被Windows系统抢占焦点。示例代码：

// 简单自定义通知窗口示例
JDialog notification = new JDialog();
notification.setUndecorated(true);
notification.setSize(300, 100);
// 定位到屏幕右下角
int screenWidth = Toolkit.getDefaultToolkit().getScreenSize().width;
int screenHeight = Toolkit.getDefaultToolkit().getScreenSize().height;
notification.setLocation(screenWidth - 320, screenHeight - 120);
notification.add(new JLabel("<html><b>title</b><br>message</html>"));
notification.setVisible(true);
// 3秒后自动关闭
new Timer(3000, e -> notification.dispose()).start();