Insomnia内置Mock服务器可快速模拟API响应,支持AI生成路由、手动配置动态响应、OpenAPI导入及Nginx本地部署。操作包括创建私有Mock服务、用AI描述生成CRUD端点、设置条件匹配与延迟、导入规范自动生成、导出Nginx配置实现离线运行。

如果您在使用Insomnia进行API开发时需要快速模拟后端接口响应,但尚未部署真实服务,则可利用Insomnia内置的Mock服务器功能生成可控、可复现的响应数据。以下是创建与配置Insomnia Mock服务器的高级操作步骤:
一、启用并创建内置Mock服务器
Insomnia原生支持Mock Server功能,无需额外安装插件或外部服务,所有Mock路由均托管于Insomnia云端(端到端加密),且完全免费。该方式适用于快速验证前端逻辑、协作联调及CI/CD流程中的离线测试。
1、启动Insomnia桌面应用,确保已登录账户(未登录将无法创建Mock Server)。
2、点击左侧边栏顶部的New按钮,在下拉菜单中选择Mock Server。
3、在弹出窗口中输入Mock服务器名称(支持中文,如“用户中心Mock”),勾选Make this Mock server private以启用私有访问控制。
4、在Environment选项中选择no environment或已有环境;勾选Save the mock server URL as an environment variable以便后续在请求中复用。
5、点击Create Mock Server,系统自动生成唯一Mock地址(形如https://mock.insomnia.rest/xxx)及配套集合。
二、通过AI辅助生成Mock路由
Insomnia集成AI能力,可根据自然语言描述自动构建符合REST语义的CRUD端点及响应结构,显著减少手动配置耗时,尤其适合OpenAPI规范缺失或接口设计初期阶段。
1、在刚创建的Mock Server对应集合中,右键点击集合名称,选择Edit Collection。
2、切换至Mock标签页,点击Add Route with AI按钮。
3、在AI提示框中输入需求描述,例如:为订单管理服务生成GET /api/orders、POST /api/orders、GET /api/orders/{id}、PUT /api/orders/{id}和DELETE /api/orders/{id}端点,返回包含id、status、amount、createdAt字段的JSON响应。
4、点击Generate,AI即时生成全部路由及示例响应体,并自动注入状态码、Content-Type头与路径参数解析逻辑。
5、逐条检查生成结果,点击单个路由右侧的Edit Response可进一步定制响应内容、延迟时间或动态变量。
三、手动配置高级Mock响应行为
除AI生成外,Insomnia允许对每个Mock路由进行细粒度控制,包括条件匹配、动态响应、延迟注入与多状态模拟,满足复杂场景调试需求。
1、在集合中展开某条Mock路由,点击Add Response添加多个响应分支。
2、为每个响应设置匹配规则:在Request Matching区域勾选Query Parameters、Headers或Body,并填写具体值(如status=processing)。
3、在响应体中使用{{uuid}}、{{timestamp}}、{{random.integer(100, 999)}}等内置模板函数生成动态数据。
4、在Response Settings中启用Delay response by,输入毫秒值(如800)模拟弱网环境。
5、勾选Set status code dynamically,在响应体中嵌入{"status": 404}即可让Insomnia自动将HTTP状态码设为404。
四、导入OpenAPI规范自动生成Mock服务
当项目已具备OpenAPI 3.0/3.1或Swagger规范文件时,Insomnia可一键解析全部端点并构建完整Mock服务,确保Mock行为与设计文档严格一致,避免人工配置偏差。
1、点击左上角Import按钮,选择Import From File或粘贴YAML/JSON格式规范文本。
2、在导入向导中勾选Create Mock Server from Specification,并指定目标Mock Server。
3、确认解析结果,Insomnia将自动为每个paths条目创建对应路由,按responses定义生成各状态码响应体。
4、对任一路由点击Edit Response,可替换默认示例为更贴近业务的JSON数据,或启用Use example from spec保持原始样例。
5、保存后,所有路由即刻生效,Mock地址可直接用于前端fetch调用或cURL测试。
五、本地化Mock部署:导出为Nginx配置包
对于需脱离Insomnia云端、在内网或CI环境中运行Mock服务的场景,可将当前Mock配置导出为标准Nginx配置片段,配合Nginx实例实现零依赖、高性能本地Mock。
1、进入Mock Server设置页(点击集合右上角⋯ → Settings)。
2、滚动到底部,点击Export as Nginx Config按钮。
3、下载生成的insomnia-mock.conf文件,将其内容合并至Nginx主配置的http块内。
4、确认Nginx已启用ngx_http_sub_module与ngx_http_lua_module(用于动态响应与延迟)。
5、执行nginx -t && nginx -s reload重载配置,此时所有Mock路由即通过localhost:8080(或其他监听端口)对外提供服务。

















