PROVIDER - 基于 OpenAPI 的 Mock 与契约校验

Prism

Prism 用 1 条命令以 OpenAPI 启动 Mock 服务器,支持静态与动态 2 种策略并内置契约校验,可拦截 3 类不规范请求,还能作为代理比对真实流量,Apache 2.0 开源 npx 即可运行;不足是强依赖文档质量、有状态场景有限。

开发工具 美国 2026.11.19
4分

详细说明

优势 5 项

用 1 条命令以 OpenAPI 文件启动 Mock 服务器,无需编写代码
支持静态与动态 2 种 Mock 策略,可按场景切换
内置契约校验,可拦截 3 类不符合规范的请求与响应
可作为代理运行,用 1 次请求比对真实流量与契约之间的差异
以 Apache 2.0 开源,npx 1 次安装即可使用

不足 4 项

依赖 OpenAPI 文档质量,文档缺失时 Mock 效果打折
有状态与业务逻辑场景支持有限
以 CLI 为主,图形化能力较弱
不适合压测级的高并发流量

服务商概述

Prism 是 Stoplight 开源的 API Mock 与契约校验工具,以 OpenAPI 文档作为唯一事实来源。

在开发工具分类里,它属于「契约驱动开发」工具:文档先行,Mock 与校验都由同一份规范生成。

核心优势

  • 零代码 Mock:1 条命令起服务
  • 双策略:静态示例与动态生成
  • 契约校验:请求与响应双向检查
  • 代理模式:真实流量比对契约
  • 开源可嵌入:npx 或容器运行

产品生态

平台能力

Mock 服务器、OpenAPI 校验、代理校验、错误与边界响应生成、多文档合并与 CLI 参数化配置。

集成

可与 Stoplight 平台、Postman、Playwright、GitHub Actions 及容器化流水线配合。

典型场景

API 优先开发、前后端并行、契约回归流水线、第三方接口对接验证。

不足之处

  • 文档依赖:规范质量决定效果
  • 状态支持:业务逻辑场景有限
  • 图形化弱:以命令行为主
  • 性能边界:不适合高并发压测

适用场景

  • API 优先团队(★★★★★):文档即 Mock
  • 契约回归(★★★★☆):双向校验实用
  • 快速原型联调(★★★★☆):分钟级可用
  • 复杂业务状态(★★☆☆☆):需自研 Mock

价格参考

项目 价格 备注
Prism CLI $0 Apache 2.0 开源免费
Stoplight 平台 按用户订阅 文档协作与治理
自建运行 $0 容器或 npx 均可

常见问题

需要 Stoplight 账号吗?

不需要,Prism 可独立运行。

支持 OpenAPI 3.0 与 3.1 吗?

支持主流 OpenAPI 版本,具体以官方文档为准。

能否校验线上流量?

可以,代理模式会比对请求与响应是否符合契约。

支持哪些语言环境?

以 Node.js 分发,也有 Docker 镜像可用。

代码示例

# 以 OpenAPI 文件启动 Mock 服务器
npx @stoplight/prism-cli mock ./openapi.yaml --port 4010

# 作为代理校验真实流量
npx @stoplight/prism-cli proxy ./openapi.yaml https://api.example.com

# 校验一次请求是否符合契约
npx @stoplight/prism-cli validate ./openapi.yaml
# openapi.yaml 片段
paths:
  /orders/{id}:
    get:
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        "200":
          description: ok
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Order"

社区与资源

  • 官方文档:https://stoplight.io/open-source/prism
  • 源码仓库:https://github.com/stoplightio/prism
  • OpenAPI 规范:https://spec.openapis.org/
前往 Prism 官网 → https://stoplight.io/open-source/prism
访问官网 ↗