moco 全称 Moco，是一款面向 Java 开发的轻量级 mock 测试框架，主要用来模拟服务端接口，在后端接口还没有开发完成，或者联调环境不稳定的时候，开发测试人员可以用 moco 快速搭建假的 HTTP 服务，按照预设规则返回固定响应数据，不用等待真实接口就绪就能开展前端联调单元测试自动化测试，它底层基于 Java 运行环境，支持 HTTP HTTPS WebSocket 协议，配置方式非常灵活，可以用 json 文件 java 代码 groovy 脚本三种方式定义请求匹配和返回结果，不需要搭建复杂的 tomcat 或者 Spring 项目，启动速度快资源占用低，非常适合敏捷开发场景下的接口 mock，很多团队把 moco 集成到 CI 持续集成流水线里面，每次自动构建的时候自动启动 mock 服务，完成自动化校验，解决依赖接口不可用导致测试阻塞的痛点，相比其他 mock 工具，moco 最大优势就是配置简单，支持动态请求匹配，能够模拟延迟异常状态码，还可以模拟接口报错超时等各种边界场景。
一 moco 核心特点
第一 轻量无侵入，不需要编写完整 web 工程，只需要一份配置文件，运行 jar 包就能启动模拟服务。
第二 多协议支持，核心支持 HTTP，扩展支持 HTTPS WebSocket，覆盖绝大多数接口联调需求。
第三 多种配置形式，支持 json 配置，适合非开发人员快速上手，也支持 Java API 和 groovy 脚本，适合复杂动态逻辑。
第四 支持场景模拟，可以自定义请求头请求参数请求体匹配规则，自定义响应状态码响应头响应体，还能设置延迟返回模拟超时。
第五 可集成扩展，可以和 JUnit TestNG Maven Gradle CI 流水线结合，融入现有测试体系。
二 moco 基础组成与运行原理
| 组成部分 | 说明 |
|---|---|
| moco-runner jar 包 | 核心运行程序，独立可执行 jar，是启动 mock 服务的核心载体 |
| 配置文件 | 一般为 json 格式，编写请求匹配规则和对应的响应内容 |
| 匹配器 | 识别请求方法 url 参数 header body，判断当前请求命中哪一条 mock 规则 |
| 响应处理器 | 命中规则之后，按照配置输出状态码 json 字符串文件内容或者自定义异常 |
| 服务端口 | 自定义监听端口，模拟真实服务对外提供访问入口 |
运行原理就是启动 moco-runner 之后，它会在指定端口监听网络请求，读取提前写好的配置规则，当外部请求发送到这个端口，moco 会比对请求特征，如果匹配成功，就直接返回预先定义好的响应数据，不会转发到真实后端服务，如果没有任何规则匹配，就返回默认 404 响应。
三 moco 快速上手步骤
第一步 确认电脑已经安装 JDK 环境，moco 依赖 Java，版本一般推荐 JDK8 及以上，在命令行执行 java version 确认环境正常。
第二步 获取 moco-runner 的 jar 包，可以从 maven 仓库下载对应版本，推荐选择稳定正式版本。
第三步 编写 json 配置文件，定义接口请求 url 请求方式，以及对应的返回 json 数据状态码。
第四步 打开命令终端，执行启动命令，指定端口号，加载 json 配置文件，启动 moco 模拟服务。
第五步 使用浏览器 postman 或者前端项目访问这个端口对应的接口，验证是否可以拿到预设 mock 返回数据。
第六步 需要新增接口规则的时候，修改 json 配置文件，重启 moco 服务，新规则就会生效。
四 moco 适用场景和局限
适用场景
1 前后端分离项目，后端接口未开发完成，前端提前联调页面。
2 自动化测试，依赖第三方外部接口，第三方接口不稳定或者有调用限额，使用 moco 模拟第三方返回。
3 异常场景测试，模拟 500 错误超时返回空数据等异常分支。
4 单元测试，隔离外部依赖，让测试只验证当前代码逻辑。
局限部分
1 核心生态更新比较缓慢，新版本 Java 高版本偶尔会出现兼容问题。
2 对复杂业务动态逻辑支持有限，如果需要复杂业务计算，推荐改用其他 mock 方案。
3 不原生支持 grpc 等新兴协议，只适合 HTTP 类接口 mock。
4 多实例多环境管理需要自己额外做封装，原生没有可视化管理后台。
【常见问题】
问题 1 moco 必须要 Java 环境吗
回答 1 moco 是 Java 开发的 mock 框架，运行 moco 必须提前安装 JDK 环境，启动 moco-runner jar 包依赖 Java 虚拟机，没有 Java 环境无法启动 moco 服务。
问题 2 moco 和 mockserver 有什么区别
回答 2 moco 主打轻量配置，适合简单 HTTP 接口模拟，上手门槛低，mockserver 功能更强大，支持更多高级断言和可视化控制台，moco 更适合快速临时 mock，复杂项目可以根据需求选择 moco 或者 mockserver。
问题 3 moco 可以模拟接口超时吗
回答 3 moco 支持模拟接口超时，在 moco 配置里面增加延迟属性，设置响应等待时间，请求命中 moco 规则之后会等待指定时长再返回响应，用来测试前端或者调用方超时重试逻辑。
问题 4 moco 可以集成到 maven 项目吗
回答 3 moco 可以集成到 maven 项目，在 maven 插件里面配置启动 moco-runner，在测试阶段自动启动 moco mock 服务，测试结束自动关闭 moco，适合自动化测试流水线使用。
【免责申明】
本文内容基于 moco 开源项目公开资料整理，项目版本迭代之后功能参数启动命令可能发生变化，相关使用请以 moco 官方仓库最新文档为准，本文仅用于技术学习参考，因环境兼容配置错误导致项目异常，相关风险由使用者自行承担。