本文介绍如何通过 launch4j maven 插件的 `singleinstance` 配置项，确保打包后的 windows 可执行文件（.exe）在同一系统中仅允许一个实例运行，避免重复启动导致的资源冲突或逻辑异常。
Launch4j 是一款广泛使用的开源工具，可将 Java 应用程序（JAR 包）封装为 Windows 原生 .exe 文件，并提供进程控制、JRE 检测、图标嵌入等增强功能。其中，单实例（Single Instance）支持是其内置的关键特性之一——它并非依赖 Java 层的互斥锁（如 FileLock 或 SharedMemory），而是在 Windows 系统级通过命名互斥体（named mutex）实现：当首个进程启动时创建唯一命名的互斥对象；后续启动尝试会检测该互斥体已存在，从而自动退出新进程（默认行为），并可选地激活已有窗口（需配合 JVM 参数与应用内逻辑）。
在 Maven 项目中，只需在 launch4j-maven-plugin 的 <configuration> 块中启用该选项：
<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，建议同时配置 <stayAlive>true</stayAlive> 防止控制台窗口闪退，并确保主窗口正确响应激活事件；
- 测试时请关闭所有相关进程（包括后台残留的 Java 进程），避免互斥体未释放导致误判。
总之，<singleInstance>true</singleInstance> 是 Launch4j 提供的轻量、可靠且零侵入的单实例保障方案，适用于绝大多数桌面 Java 应用的 EXE 封装场景。合理配置后，无需修改业务代码即可获得系统级的实例保护能力。
立即学习“Java免费学习笔记（深入）”；
