【亲测免费】 WireMock 开源项目教程

2026-01-16 10:38:28作者：翟江哲Frasier

WireMock是每位API开发者与测试者的得力助手，一个广受赞誉的开源工具，每月超过500万次下载，证明了其在构建稳定测试与开发环境方面的不可或缺。自2011年由Tom Akehurst以Java起家，如今WireMock已跨越多种编程语言和技术栈，无论是作为库集成于项目，还是作为独立服务器运行，都能游刃有余。它支持代码编写、REST API配置、JSON文件定义乃至通过代理记录HTTP流量来创建模拟API，满足各类复杂需求。具备精细的请求匹配规则与基于Handlebars的动态响应生成能力，加之广泛的扩展点与API，让WireMock成为易于融入任何工作流程的强大工具。无论单元测试、独立运行或是容器部署，WireMock都让你的API模拟变得简单高效，赋能软件开发的每一个环节。加入Wiremock社区，共同探索更多可能！

项目地址：https://gitcode.com/gh_mirrors/wir/wiremock

项目介绍

WireMock 是一个流行的开源 API 模拟工具，每月下载量超过 500 万次。它可以帮助你创建稳定的测试和开发环境，隔离不可靠的第三方服务，并模拟尚不存在的 API。自 2011 年由 Tom Akehurst 作为 Java 库开始，WireMock 已经扩展到支持多种编程语言和技术栈。它可以作为库或客户端包装器在许多语言中运行，或者作为独立服务器运行。WireMock 有一个庞大的社区和生态系统支持，支持多种创建模拟 API 的方法，包括在代码中、通过 REST API、作为 JSON 文件以及通过记录 HTTP 流量代理到另一个目的地。

项目快速启动

安装 WireMock

你可以通过 Docker 快速启动 WireMock。以下是使用 Docker 运行 WireMock 的命令：

docker run -it --rm -p 8080:8080 --name wiremock wiremock/wiremock:3.9.1

创建一个简单的模拟 API

WireMock 支持通过 JSON 文件创建模拟 API。以下是一个简单的示例：

创建一个 JSON 文件 hello-world.json：

{
  "request": {
    "method": "GET",
    "url": "/hello-world"
  },
  "response": {
    "status": 200,
    "body": "Hello, world!"
  }
}

将该文件放置在 WireMock 的 mappings 目录中。
启动 WireMock 后，访问 http://localhost:8080/hello-world，你将看到响应 Hello, world!。

应用案例和最佳实践

加速客户 onboarding

Zenus Bank 利用 WireMock 加速了客户 onboarding 流程。通过模拟 API，他们能够在不依赖第三方 API 的情况下快速开发和测试新功能。

并行开发

WireMock 允许团队成员在 API 尚未完全实现时进行并行开发。通过模拟 API，开发者可以专注于前端或后端开发，而不必等待 API 的完成。

混沌工程

WireMock 支持负载和混沌测试，帮助团队提高 API 的鲁棒性。通过模拟各种异常情况，团队可以确保其系统在生产环境中能够稳定运行。

典型生态项目

WireMock Cloud

WireMock Cloud 是 WireMock 的托管版本，提供了一个 Web UI 和团队协作功能。它支持 OpenAPI 和 Swagger，以及混沌测试。WireMock Cloud 提供了一个慷慨的免费层，适合初创团队使用。

WireMock Extensions

WireMock 支持多种扩展点，允许开发者根据需要自定义功能。这些扩展可以用于处理复杂的请求匹配、动态生成响应等。

WireMock 社区

WireMock 是一个社区驱动的项目，拥有活跃的 Slack 社区和用户贡献的文档。社区成员可以分享最佳实践、提出问题并贡献代码。

通过以上内容，你可以快速了解并开始使用 WireMock 开源项目。希望这篇教程对你有所帮助！

wiremock