Insomnia中解决“SSL certificate verification failed”错误有四种方法:一、全局禁用SSL验证;二、为特定域名添加自签名CA证书;三、通过环境变量动态控制;四、命令行启动时临时绕过验证。

如果您在使用Insomnia进行API调试时遇到“SSL certificate verification failed”错误,且目标服务使用的是自签名证书,则需调整SSL验证行为以适配开发环境。以下是具体配置方法:
一、全局禁用SSL证书验证
此方法适用于本地快速调试,通过关闭全局SSL验证跳过所有证书校验,操作简单但仅限可信开发环境使用。
1、启动Insomnia,点击左上角菜单栏的Insomnia(macOS)或文件(Windows/Linux),选择偏好设置。
2、在左侧导航栏中点击常规选项卡。
3、向下滚动至网络区域,找到跳过SSL验证选项。
4、勾选该复选框,保存设置并重启Insomnia。
5、此时所有请求将忽略证书有效性、域名匹配及签名链完整性检查。
二、为特定域名配置自签名证书信任
该方式不关闭全局验证,而是将自签名证书显式添加到Insomnia的信任列表中,兼顾安全性与开发便利性。
1、获取目标服务的自签名CA证书文件(通常为.pem或.crt格式)。
2、打开Insomnia,进入环境管理界面(可通过右上角齿轮图标→管理环境)。
3、点击当前使用的环境右侧的编辑按钮,切换到SSL证书标签页。
4、点击添加证书按钮。
5、在弹出窗口中填写:域名(如 localhost 或 127.0.0.1)、上传CA证书文件,留空私钥与密码字段(仅CA信任场景无需私钥)。
6、保存后,Insomnia对该域名的所有HTTPS请求将仅验证该CA签发的证书,不再依赖系统根证书库。
三、通过环境变量动态控制验证行为
适用于多环境共存场景,利用环境变量在不同配置间切换,避免手动修改设置。
1、在Insomnia中创建两个独立环境:例如命名为development和production。
2、为development环境添加变量:SKIP_SSL_VERIFICATION,值设为true。
3、在请求的Pre-request Script中插入以下JavaScript代码:
if (environment.SKIP_SSL_VERIFICATION === 'true') { insomnia.settings.set('skipSslVerification', true); }
4、确保该脚本在每次发送请求前执行。
5、切换环境时,脚本自动启用或禁用SSL验证,实现按环境隔离安全策略。
四、命令行启动时临时绕过验证
当通过CLI方式运行Insomnia(如配合自动化测试脚本),可直接在启动参数中覆盖验证设置。
1、关闭正在运行的Insomnia桌面客户端。
2、在终端中执行以下命令(以macOS为例):
open -n -a "Insomnia" --args --skip-ssl-verification
3、Windows用户使用PowerShell运行:
Start-Process "Insomnia.exe" -ArgumentList "--skip-ssl-verification"
4、Linux用户执行:
insomnia --skip-ssl-verification
5、此次启动的Insomnia实例将全程跳过SSL证书验证,且不影响其他会话的默认设置。

















