TOOL PICKS / 2026.11.14
前端或集成测试要把依赖的 HTTP API 换成可重复的本地替身时,真正要问的是:有没有维护中的 OpenAPI、要不要对着真实服务录流量、要不要图形界面手改路由、以及这份 mock 怎么进 Git 和 CI。
结论:规范已经写好、要从 OpenAPI 直接长出 mock,或先用校验代理看实现是否跑偏,优先 Prism;需要在桌面里手改路由、只 mock 一部分并把其余请求转发出去,优先 Mockoon;要在测试代码或 JSON 文件里做精细匹配,或对真实 API 做录制回放,优先 WireMock 开源版。不要把「从 OpenAPI 一键导入」算在 WireMock OSS 头上——官方对照表把这项写成 Cloud 能力。
以下为 2026 年 11 月 14 日的文档核验对比,不是本机安装或联调实测;产品名称、镜像标签与套餐边界以各官网当日页面为准,可能会变。
把任务钉死:同一份前端或测试在本地和 CI 里,都能打到结构稳定、可重复的依赖 API 替身。用这个尺子量工具,比口头比较「谁更好看」有用。
先钉任务,再谈 mock 工具
本文只服务一个固定任务:在本地开发或 CI 里,为前端联调或集成测试提供可重复的 HTTP API 替身,从而不再把不稳定的下游沙箱当作日常依赖。包含:入口怎么写路由、能不能从 OpenAPI 出发、如何做部分代理或录制回放、怎么运行和分发、许可怎么划分。不包含:生产网关、服务网格、云厂商 API 管理平台,也不包含对三家做延迟或资源占用的实测。
- 读者画像:要在笔记本或流水线里把依赖 API mock 起来的前端、测试或后端,手里可能已有一份 OpenAPI,也可能只有可访问的下游服务。
- 成功标准:能按「有没有规范、要不要录流量、要不要 GUI、要不要进 Git/CI」做出可执行选择;知道哪项能力属于开源版,哪项属于托管/Pro 产品。
- 停止条件:若需求其实是「用集合运行器回归已有 HTTP 请求」(见站内 Bruno / Insomnia / Postman 一文),或要在生产流量上做网关,本文决策表不适用。
三家文档口径对照
Mockoon(桌面应用 + CLI;GitHub 仓库许可为 MIT,CLI 页也标明 MIT license):文档核验当日,文档站侧栏显示最新版为 v9.10.0。下载页提供 Windows(含 winget / choco)、Linux(deb / rpm / AppImage / snap 等)和 macOS(Universal / Intel / Silicon,以及 brew install --cask mockoon)安装包。桌面端把每个 mock API 存成单独的 JSON 数据文件,文档写明可与其他用户共享、交给 CLI 使用,或放进 Git 仓库。
OpenAPI 文档写明:支持导入 OpenAPI v2(Swagger)和 v3 的 JSON/YAML;环境可导出为 OpenAPI 3。桌面里用「New local environment from OpenAPI/Swagger」新建,从 v9.6.0 起也可用「Reimport from OpenAPI/Swagger」更新已有环境。官方明确:再导入时只会补新路由或新响应,不会修改或删除已有路由和响应。CLI 也可以直接把 OpenAPI 文件当作 --data 启动,但 CLI README 与兼容性文档提醒:OpenAPI 与 Mockoon 的特性不能完整互换,部分 OpenAPI 属性尚无对应实现,Mockoon 的规则等行为也不能靠 OpenAPI 完整保留;若要用模板、规则等完整能力,应使用 Mockoon 自己的数据文件。
代理模式用于「部分 mock」:已声明的路由由 Mockoon 拦截,未匹配的请求转发到指定 URL;可勾选去掉 API 前缀,也可为转发请求和返回响应附加代理头。CLI 页写明与桌面功能对等,包括模板、响应规则、代理模式和 OpenAPI 兼容,并提供 npm 包 @mockoon/cli、官方 Docker 镜像和 GitHub Action。CLI 页同时公告 Mockoon Pro(自托管的团队协作、数据同步和 mock 部署)已推出——这与开源桌面/CLI 不是同一份产品,选型时不要混为一谈。

WireMock 开源版(Apache 2.0;FAQ 写明「completely free under the Apache 2.0 license」):可作独立服务,用 Java API、HTTP 上的 JSON 或 JSON 文件配置;官方提供 JAR 和 Docker 两种分发。Docker 文档在 2026 年 11 月 14 日给出的示例镜像为 wiremock/wiremock:3.13.2,映射 8080 端口;容器内以 /home/wiremock 为根目录读取 mappings 与 __files,因此可把宿主机目录挂进去加载 stub。独立服务还可通过 REST 管理接口维护。
录制回放是 OSS 的主路径之一。Record and Playback 文档写明:可把代理到已有 API 的交互录成 stub。独立进程默认端口 8080 时,可打开 http://localhost:8080/__admin/recorder,填目标 URL 后开始录制,再把请求打到 WireMock;官方注明 只有在停止录制时才创建 stub,停止后这些 stub 立即进入回放,无需额外操作。也可用 Admin API 或 Java DSL 启停录制。另有 snapshot 途径,文档认为与录制可得同一类结果,新手更建议从录制入手。

关键分界在官方「OSS vs. Cloud at a glance」表:WireMock OSS 的用户界面被写成「Code and configuration files」;「OpenAPI / Swagger import」一行,OSS 是「Manual stub authoring only」,「Native import from Swagger and OpenAPI specs」写在 Cloud 列。本文比较的是开源引擎,不把 Cloud 的一键导入、托管工作区或 drift 告警算进 OSS。Cloud 另有免费档,但功能集合与 OSS 不同,不能用「都叫 WireMock」混过这张表。
Prism(Stoplight 开源;仓库 LICENSE 为 Apache License 2.0):定位是命令行上的 HTTP mock 与校验代理,以 OpenAPI v2 或 v3 文档为数据源。概念文档把能力分成 Mocking 和 Validation Proxy 两条,并写明「主要经命令行使用」;同时写了一条边界:它还不是测试套件里做可编程 mock 的工具(文档写 planned for the future)。
CLI 只有两条命令。prism mock 按规范起一个假 HTTP 服务,默认监听 http://127.0.0.1:4010,并用符合类型的示例、默认值或「足够真实」的数据填充响应;也可用 Prefer 头(如 code=404)强制返回规范里已声明的状态码。规范文件变更时会自动重载,不必手动重启。 prism proxy openapi.yml http://api.example.com/ 则把合法请求转到上游,并按同一套校验逻辑检查请求和响应;违规可打在标准输出和 sl-violations 响应头上,也可打开 --errors 直接报错。校验代理指南还写:若上游返回 501,Prism 会尝试按规范 mock 该调用。

内容类型边界必须写进决策:Prism 支持 JSON、XML 和 URL 编码表单;不支持 multipart/form-data,也不支持 PDF、图片、zip 等二进制。这类接口不要用 Prism 硬 mock。
决策表:五个核验维度
下表只整理 2026 年 11 月 14 日公开文档可核对的口径,便于例会拍板;Pro 与 Cloud 的席位价格请以官网当日页面为准,本文不把标价抄成报价。
| 维度 | Mockoon | WireMock OSS | Prism |
|---|---|---|---|
| 入口形态 | 桌面设计 JSON 数据文件,再用 CLI/Docker/Action 跑 | 代码、JSON 文件或 Admin HTTP API;可录制回放 | 命令行 prism mock / prism proxy,以 OpenAPI 为数据源 |
| OpenAPI | 可导入 v2/v3,导出 v3;CLI 也可直接喂规范,但官方提醒不能对等全部特性 | 官方对照表:OSS 为手工编写 stub;原生导入属 Cloud | 以 OpenAPI v2/v3 文档驱动全部 mock 与校验决策 |
| 代理 / 录制 | 未匹配路由转发到指定 URL,可去前缀、加代理头 | 可对已有 API 录制,停止后立即回放;提供 recorder 页与 API | prism proxy 转发并按规范校验;上游 501 时可改 mock |
| 运行与分发 | Windows / Linux / macOS 桌面;npm CLI、官方 Docker、GitHub Action;JSON 可进 Git | 独立服务,官方提供 JAR 与 Docker(文档示例 wiremock/wiremock:3.13.2,可挂载 mappings) | 主要经 CLI;默认 127.0.0.1:4010;规范变更自动重载;文档称尚不适合作为测试套件内的可编程库 |
| 许可 | MIT(仓库与 CLI 页);Pro 是另售的自托管协作产品 | Apache 2.0,FAQ 写明开源版完全免费;托管版为 Cloud | Apache License 2.0 |
口诀:先看规范在不在,再看要不要录流量,最后才看界面。按下面几条依次排除即可。
- 规范先行:已有维护中的 OpenAPI,要把 mock 直接从文档长出来,或用校验代理看实现是否漂移,选 Prism。
- 要手改路由和部分 mock:需要 GUI、只 mock 一部分并把其余请求转发到真实服务,再把 JSON 文件送进 Git/CI,选 Mockoon。
- 要录真实交互或写进测试代码:选 WireMock OSS。不要假设开源版能「导入一份 OpenAPI 就生成全部 stub」。
- 上传与二进制:接口是 multipart 或要返回 PDF/图片/zip,先排除 Prism。
- 不要混产品线:Mockoon Pro 的团队同步、WireMock Cloud 的原生 OpenAPI 导入,都不是开源对照表里的默认能力。
怎么落地,以及何时不要换
- 本周:先填两格——团队是否已有一份会改的 OpenAPI;日常联调是「完全假服务」还是「部分假、其余打到下游」。没有规范又需要从零手写大量路由时,不要默认 Prism。
- 试点:用一份无密钥的公开规范或脱敏副本,按官方入口各起一次服务(Prism 用
prism mock,Mockoon 用桌面或 CLI,WireMock 用文档中的 Docker 示例),只检查「声明过的路径能否按文档方式打到」,不要一上来比界面手感。 - 进 CI:Mockoon 文档提供 CLI、Docker 与 GitHub Action;WireMock 可用官方镜像并挂载
mappings;Prism 把规范文件放进仓库后在流水线跑prism mock或prism proxy --errors。数据或规范必须进版本库,避免每人一份只存在本机的私货。 - 不要换的情况:测试套件已经用 Java/客户端库把 WireMock 嵌进用例——不要为了「看一下桌面」拆掉可重复的测试夹具;团队已经把 OpenAPI 当合同、并且依赖校验代理发现漂移——继续用 Prism,不必再手维护一份平行 stub;只是想跑已有 HTTP 集合回归——回到集合运行器,而不是再引入一台 mock 服务器。

我们的判断:本地 API 替身的胜负手是「规范在不在」和「要不要录真实流量」,不是皮肤。文档核验下:有 OpenAPI 且要合同与实现一起看,优先 Prism;要 GUI 手改和部分转发,优先 Mockoon;要录制回放或在测试代码里精细匹配,优先 WireMock OSS。无本机实测前,先用上表开例会,再决定要不要做一周试点。
参考链接
- Mockoon Docs:Import/export in OpenAPI format
- Mockoon Docs:Partial API mocking with proxy mode
- Mockoon Docs:Data files
- Mockoon:CLI(含 MIT license 与 Docker / GitHub Action 示例)
- Mockoon CLI README:直接使用 OpenAPI 文件的兼容边界
- Mockoon:Download
- Mockoon Docs:About the documentation
- GitHub:mockoon/mockoon(许可标 MIT)
- WireMock Docs:WireMock Cloud(含 OSS vs Cloud 对照表)
- WireMock Docs:Record and Playback
- WireMock Docs:Running in Docker
- WireMock Docs:Standalone Service
- WireMock Docs:FAQ(Apache 2.0)
- GitHub:wiremock/wiremock
- Prism Docs:Concepts
- Prism Docs:CLI
- Prism Docs:Validation Proxy
- GitHub:stoplightio/prism LICENSE(Apache 2.0)


Список комментариев (0 записей):
Показать ещё отзывы Загрузка...