Neutralino双应用并行时的关闭异常问题

问题描述 #

我在Windows 11上用Neutralino开发小型桌面工具时，遇到了多实例启动后的关闭异常问题：

复现步骤：

• 双击桌面图标启动第一个应用实例
• 双击桌面图标启动第二个应用实例
• 点击调用Neutralino.App.exit()的按钮关闭第二个实例

异常现象：

• 第一个应用实例被强制终止
• 第二个应用窗口关闭，但进程残留于任务管理器中

配置信息：
第一个实例的neutralino.config.json关键配置：

"port": 0,
"tokenSecurity": "one-time",
"exitProcessOnClose": false

第二个实例的neutralino.config.json关键配置：

"port": 63976,
"tokenSecurity": "none",
"exitProcessOnClose": false

补充测试结果：

• 将两个实例的port都改为0后，问题依然存在
• 直接双击应用exe文件启动第二个实例时，该问题完全消失

请问这是什么原因？为什么通过桌面图标启动会触发异常行为？

问题根源分析 #

这个问题的核心是Windows桌面图标启动时的工作目录配置错误，导致Neutralino的IPC通信混淆了不同实例的进程：

1. 桌面图标的工作目录陷阱
   Windows桌面快捷方式默认的"起始位置"若指向多个实例共享的目录，会导致第二个实例启动时复用第一个实例的IPC上下文。当调用Neutralino.App.exit()时，IPC信号错误发送给第一个实例，导致其被终止；而第二个实例因IPC通道混乱，无法完成完整退出流程，最终残留进程。

2. 直接双击exe的差异
   直接双击exe时，Windows会自动将exe所在目录设为工作目录，每个实例的IPC资源（命名管道、临时端口）完全独立，不会出现上下文混淆，因此关闭行为正常。

修复方案 #

1. 修正桌面快捷方式的工作目录
   右键桌面图标 → 属性 → 快捷方式选项卡，确保"起始位置"设置为当前应用实例的独立安装目录，禁止多个实例共享同一起始位置。

2. 强制每个实例使用独立IPC标识
   在neutralino.config.json中添加唯一的appName配置，让Neutralino为每个实例生成独立IPC命名空间：

"appName": "MyAppInstance01" // 第二个实例改为MyAppInstance02

3. 启用进程随窗口关闭退出（可选）
   若无需后台进程残留，可将exitProcessOnClose设为true，窗口关闭时直接终止整个进程：

"exitProcessOnClose": true

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