如何使用 Launch4j Maven 插件限制 Java 应用为单实例运行

本文介绍如何通过 launch4j maven 插件的 `singleinstance` 配置项，确保打包后的 windows 可执行文件（.exe）在同一系统中仅允许一个实例运行，避免重复启动导致的资源冲突或逻辑异常。

Launch4j 是一款广泛使用的开源工具，可将 Java 应用程序（JAR 包）封装为 Window

s 原生 .exe 文件，并提供进程控制、JRE 检测、图标嵌入等增强功能。其中，单实例（Single Instance）支持是其内置的关键特性之一——它并非依赖 Java 层的互斥锁（如 FileLock 或 SharedMemory），而是在 Windows 系统级通过命名互斥体（named mutex）实现：当首个进程启动时创建唯一命名的互斥对象；后续启动尝试会检测该互斥体已存在，从而自动退出新进程（默认行为），并可选地激活已有窗口（需配合 JVM 参数与应用内逻辑）。

在 Maven 项目中，只需在 launch4j-maven-plugin 的 块中启用该选项：

  com.github.akman
  launch4j-maven-plugin
  2.13.0
  
    
      l4j-gui
      package
      
        launch4j
      
      
        gui
        ${project.build.directory}/${project.artifactId}-${project.version}.jar
        ${project.build.directory}/myapp.exe
        
          com.example.MyApp
        
        
        true
        
        
      
    
  

✅ 注意事项：

• singleInstance 仅在 Windows 平台生效（底层调用 Win32 CreateMutexW），Linux/macOS 下会被忽略；
• 启用后，第二次启动时进程将立即终止，不会进入 main() 方法——因此，若需向已有实例传递参数（如打开新文件），必须结合 JVM 启动参数（如 -Dlaunch4j.singleInstance=true）并在 Java 代码中监听 IPC 信号（推荐使用 JUnique 或 JNIWrapper 等第三方库）；
• 若应用含 GUI，建议同时配置 true 防止控制台窗口闪退，并确保主窗口正确响应激活事件；
• 测试时请关闭所有相关进程（包括后台残留的 Java 进程），避免互斥体未释放导致误判。

总之，true 是 Launch4j 提供的轻量、可靠且零侵入的单实例保障方案，适用于绝大多数桌面 Java 应用的 EXE 封装场景。合理配置后，无需修改业务代码即可获得系统级的实例保护能力。