使用jpackage生成exe后，Java单实例锁失效的原因及解决方法？

1. 工作目录不一致 #

命令行运行Jar时，程序工作目录是执行java -jar命令的当前目录；而jpackage生成的exe默认工作目录为程序安装目录或系统临时目录，导致原代码中依赖相对路径或当前工作目录的锁文件（如临时文件）无法在多实例间共享，每个实例都会创建独立的锁文件，无法检测到已有进程。

2. 原生包装进程隔离 #

jpackage生成的exe是一个原生包装器进程，它会先启动自身，再通过该进程启动Java虚拟机进程。原单实例代码仅检测Java进程的锁资源，而包装器进程未被纳入检测范围，多次启动exe时，每个包装器都会启动独立的Java进程，绕过了原有的锁检测。

3. 锁资源生命周期不匹配 #

若原代码使用文件锁，可能存在锁未与进程生命周期绑定的问题：原生包装器进程退出时未正确释放锁，或Java进程的锁被包装器的进程空间隔离，导致后续实例无法识别已存在的锁。

1. 统一锁文件路径 #

使用系统全局唯一的固定路径存储锁文件，确保所有实例访问同一个锁资源：

// Windows下使用APPDATA目录，跨平台可适配不同系统的公共目录
String lockDir = System.getenv("APPDATA") + File.separator + "YourAppName";
new File(lockDir).mkdirs();
File lockFile = new File(lockDir, "app.lock");
// 后续使用文件锁逻辑，确保锁文件路径全局唯一

2. 使用Windows原生命名互斥体（推荐） #

通过JNA调用Windows API创建全局命名互斥体，这是Windows平台最可靠的单实例检测方式，能同时覆盖原生包装器进程和Java进程：

• 引入JNA依赖（Maven示例）：

<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna</artifactId>
    <version>5.13.0</version>
</dependency>
<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna-platform</artifactId>
    <version>5.13.0</version>
</dependency>

• 实现互斥体检测：

import com.sun.jna.platform.win32.Kernel32;
import com.sun.jna.platform.win32.WinNT;

public class SingleInstanceLock {
    private static final String MUTEX_NAME = "Global\\YourUniqueAppMutex";
    private static WinNT.HANDLE mutexHandle;

    public static boolean isInstanceRunning() {
        mutexHandle = Kernel32.INSTANCE.CreateMutexW(null, true, MUTEX_NAME);
        return Kernel32.INSTANCE.GetLastError() == WinNT.ERROR_ALREADY_EXISTS;
    }

    public static void releaseLock() {
        if (mutexHandle != null) {
            Kernel32.INSTANCE.CloseHandle(mutexHandle);
        }
    }
}

程序启动时调用isInstanceRunning()，若返回true则直接退出。

3. 优化端口绑定逻辑（跨平台备选） #

若使用端口监听实现单实例，需确保绑定固定端口并禁用地址复用：

ServerSocket serverSocket = null;
try {
    serverSocket = new ServerSocket(12345, 1, InetAddress.getByName("localhost"));
    // 端口绑定成功，说明无其他实例
} catch (BindException e) {
    // 端口被占用，已有实例运行，退出程序
    System.exit(1);
}
// 程序退出时关闭ServerSocket
Runtime.getRuntime().addShutdownHook(new Thread(() -> {
    if (serverSocket != null) {
        try {
            serverSocket.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}));

注意：需选择不常用的端口，避免与其他程序冲突。

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