如何检测Java TrayIcon是否已运行，避免重复创建托盘

这个问题我之前做桌面应用时也碰到过！核心原因是每次运行Jar都会启动一个全新的JVM进程，每个进程都会独立创建自己的TrayIcon，自然就出现了重复托盘的情况。这里有两个实用的解决方案，你可以根据场景选择：

一、实现单实例运行（最根本的解决办法） #

要彻底避免重复托盘，首先得确保同一时间只有一个程序实例在运行。常用的实现方式有两种：

1. 端口监听法 #

利用“同一端口只能被一个进程占用”的特性，启动时尝试绑定一个专属端口，如果绑定失败，说明已有实例在运行，直接退出当前进程：

import java.net.ServerSocket;

public class SingleAppInstance {
    private static ServerSocket lockSocket;

    public static boolean isInstanceAlreadyRunning() {
        try {
            // 选一个不常用的端口（比如9999）作为实例锁
            lockSocket = new ServerSocket(9999);
            return false;
        } catch (Exception e) {
            // 端口被占用，说明已有实例
            return true;
        }
    }

    public static void main(String[] args) {
        if (isInstanceAlreadyRunning()) {
            System.out.println("程序已经在运行中，请勿重复启动！");
            System.exit(0);
        }

        // 这里执行你的TrayIcon创建逻辑
        initTrayIcon();
    }

    private static void initTrayIcon() {
        // 你的TrayIcon初始化代码
    }
}

优点：实现简单，跨平台兼容性好；注意点：尽量选一个冷门端口，避免和其他程序冲突。

2. 文件锁法 #

通过创建一个专属锁文件并获取独占锁，确保只有一个进程能持有该锁，进程退出时自动释放锁：

import java.io.File;
import java.io.RandomAccessFile;
import java.nio.channels.FileChannel;
import java.nio.channels.FileLock;

public class SingleInstanceFileLock {
    private static FileLock appLock;

    public static boolean isInstanceAlreadyRunning() {
        try {
            // 在用户目录下创建锁文件（可自定义路径）
            File lockFile = new File(System.getProperty("user.home"), ".my_app_lock");
            FileChannel channel = new RandomAccessFile(lockFile, "rw").getChannel();
            
            // 尝试获取非阻塞的独占锁
            appLock = channel.tryLock();
            if (appLock == null) {
                channel.close();
                return true;
            }

            // 注册关机钩子，程序退出时释放锁并删除文件
            Runtime.getRuntime().addShutdownHook(new Thread(() -> {
                try {
                    appLock.release();
                    channel.close();
                    lockFile.delete();
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }));
            return false;
        } catch (Exception e) {
            return true;
        }
    }

    public static void main(String[] args) {
        if (isInstanceAlreadyRunning()) {
            System.out.println("程序已在运行！");
            System.exit(0);
        }
        initTrayIcon();
    }

    private static void initTrayIcon() {
        // 你的TrayIcon初始化代码
    }
}

优点：不会和端口冲突，更稳定；注意点：需要处理不同操作系统的文件权限问题，锁文件路径尽量选用户有权限读写的目录。

二、检查已有TrayIcon（辅助补充） #

这个方法只能防止同一进程内重复添加托盘图标，无法解决多进程重复启动的问题，适合配合单实例方案一起使用：

import java.awt.SystemTray;
import java.awt.TrayIcon;

public class TrayIconChecker {
    public static boolean isTrayIconExists() {
        if (!SystemTray.isSupported()) {
            return false;
        }
        SystemTray systemTray = SystemTray.getSystemTray();
        TrayIcon[] existingIcons = systemTray.getTrayIcons();
        
        // 通过tooltip、图标名称等标识判断是否已有我们的托盘
        for (TrayIcon icon : existingIcons) {
            if ("我的应用托盘".equals(icon.getToolTip())) {
                return true;
            }
        }
        return false;
    }

    public static void main(String[] args) {
        if (isTrayIconExists()) {
            System.out.println("托盘图标已存在！");
            return;
        }

        // 创建TrayIcon时设置统一的tooltip标识
        TrayIcon myTrayIcon = new TrayIcon(/*你的图标对象*/, "我的应用托盘");
        try {
            SystemTray.getSystemTray().add(myTrayIcon);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

总结 #

优先选择单实例运行的方案，从根源上避免多次启动程序；如果需要额外防止同一进程内重复添加托盘，再配合托盘图标检查逻辑即可。

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