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

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

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

Linux Desktop Control

Linux 桌面自动化与控制。适用于以下场景：（1）截取屏幕或窗口的截图，（2）控制鼠标和键盘，（3）管理窗口，（4……

下载

<plugin><groupid>com.github.akman</groupid><artifactid>launch4j-maven-plugin</artifactid><version>2.13.0</version><executions><execution><id>l4j-gui</id><phase>package</phase><goals><goal>launch4j</goal></goals><configuration><headertype>gui</headertype><jar>${project.build.directory}/${project.artifactId}-${project.version}.jar</jar><outfile>${project.build.directory}/myapp.exe</outfile><classpath><mainclass>com.example.MyApp</mainclass></classpath><!-- 关键配置：启用单实例模式 --><singleinstance>true</singleinstance><!-- 可选：指定互斥体名称（默认为 exe 文件名的哈希值），便于调试或跨版本兼容 --><!-- <mutexName>MyApp_SingleInstance_Mutex</mutexName> --></configuration></execution></executions></plugin>

✅ 注意事项：

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

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

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南