Insomnia v9.2.0添加前置请求脚本报错：hiddenWindowPort未定义

算力阿峰

2026-6-22

解决Insomnia前置脚本执行超时（hiddenWindowPort undefined）问题

以下是针对该问题的几种有效解决方式：

升级到最新稳定版
旧版本Insomnia存在隐藏窗口端口相关的已知bug，直接下载最新版覆盖安装，多数情况下能直接解决该问题。
重置Insomnia应用状态
缓存或配置损坏可能引发这类异常，操作步骤：
1. 完全关闭Insomnia
2. 找到对应系统的配置目录：
  - Windows：%APPDATA%\Insomnia
  - macOS：~/Library/Application Support/Insomnia
  - Linux：~/.config/Insomnia
3. 备份该目录后删除，重新启动Insomnia
排查系统安全软件拦截
防火墙、杀毒软件可能会阻止Insomnia启动隐藏窗口进程，临时关闭这类软件测试，若恢复正常，将Insomnia加入安全软件白名单即可。
手动指定hiddenWindowPort环境变量
通过环境变量强制Insomnia使用未被占用的端口，操作方式：
- Windows（命令行启动）：
```
set INSOMNIA_HIDDEN_WINDOW_PORT=9300 && start insomnia.exe
```
- macOS/Linux（终端启动）：
```
INSOMNIA_HIDDEN_WINDOW_PORT=9300 insomnia
```
可选择9300、9400这类常规未占用端口，设置完成后启动Insomnia再测试脚本。
禁用硬件加速
硬件加速可能与隐藏窗口机制冲突，关闭方法：
启动Insomnia时按住Shift键（Windows/macOS通用），在弹出的对话框中勾选"Disable Hardware Acceleration"，确认后重启应用。