简介这是一款面向前端开发者与接口调试人员的HTTP自动回复请求软件即一键Mock工具用于解决后端接口尚未完成时前端开发受阻的问题。软件提供直观界面可快速创建、编辑和管理Mock接口无需复杂安装或外部插件支持依据接口文档配置模拟数据并一键启动服务适用于接口联调、数据模拟测试等场景。压缩包共33个文件约5.36MB包含exe主程序、dll运行库、xml配置说明、pdf使用与更新文档、config配置、db数据文件及log日志等覆盖程序运行、数据存储与配置管理所需组件。运行环境为Win10 x64依赖.NET Framework 4.6.2。目前已有490人学习下载。借助该工具开发者可摆脱传统Mock服务器搭建的繁琐流程快速完成接口模拟与调试提升开发效率与质量。1. 一键 Mock 工具到底在解决什么从联调被 502 卡住说起联调时最怕的不是接口报错而是接口根本还没写好。前端页面已经画完后端同学还在改数据库字段你打开 F12 一看请求发出去直接unexpected status 502 bad gateway或者干脆http request failed: timeout was reached。这时候如果有一个 Http 自动回复请求软件也就是常说的 Mock 工具把目标 URL 接管过来按约定好的 JSON 直接返回前端就能继续往下走。Mock 的本质不是造假数据而是在真实接口缺位时用可控的 HTTP 响应把调用链先跑通。它适合前端、测试、后端早期联调也适合演示环境里需要稳定返回值的场景。理解 http 协议里请求方法、状态码、Header、Body 这几件事是选型和排错的基础否则你连 Mock 规则为什么没命中都看不出来。2. 选型与原理Mock 模式在 HTTP 链路的哪一层生效2.1 三种常见 Mock 模式静态文件、本地服务、代理拦截很多人一上来就问用哪个工具其实先要确定 Mock 模式。第一种是静态文件 Mock把 JSON 放在本地目录用http file server或简单静态服务器暴露出去改 URL 指向它。优点是零依赖缺点是没法根据请求参数动态返回也没法模拟 500、302 这类状态码。第二种是本地 Mock 服务起一个进程监听端口按路由和方法返回不同内容适合需要动态响应的场景。第三种是代理拦截工具作为中间人转发请求命中规则就返回 Mock没命中就透传到真实后端。这种模式最贴近真实联调但配置成本也最高。我一般会按这个顺序选如果只是前端自己跑页面用本地 Mock 服务如果后端已经有一半接口好了用代理拦截如果只是临时给测试一个固定返回静态文件最省事。注意代理拦截模式下要处理好http 连接复用否则高频请求下容易出现连接被复用导致 Mock 规则串了的情况。2.2 请求匹配的四个维度方法、路径、Header、BodyMock 工具能不能用关键看匹配规则。一个可靠的匹配至少要看四个维度请求方法GET/POST/PUT/DELETE、路径含 query 参数、关键 Header比如Content-Type、自定义 token、Body 里的字段。只按路径匹配是最容易翻车的因为同一个路径可能 GET 查列表、POST 建数据返回结构完全不同。下面是一个最小匹配规则的 JSON 描述很多 Mock 工具都支持类似结构{ match: { method: POST, path: /api/user/login, headers: { Content-Type: application/json }, body: { username: admin } }, response: { status: 200, headers: { Content-Type: application/json }, body: { code: 0, token: mock-token-123, user: { id: 1, name: admin } } } }这段规则的意思是只有 POST 到/api/user/login、Content-Type 是 JSON、且 Body 里 username 等于 admin 的请求才返回这个成功响应。参数说明match里少写一个维度命中范围就变大容易误伤其他请求response.status可以设成 401、500 来模拟异常分支headers里如果漏了Content-Type前端 axios 可能解析失败。2.3 动态响应用模板变量让 Mock 数据不再写死静态返回只能应付一时真正好用的一键 Mock 工具要支持模板变量。常见做法是在响应体里用占位符引用请求参数比如{{query.page}}、{{body.userId}}、{{random.int(1,100)}}。这样同一个规则可以返回不同数据分页、详情、随机列表都能覆盖。// 响应模板示例根据请求参数动态生成 const responseTemplate { code: 0, data: { page: {{query.page}}, pageSize: {{query.pageSize}}, total: 100, list: {{random.array(10)}} }, message: success };逻辑说明{{query.page}}会被替换成 URL 里的 page 参数{{random.array(10)}}生成 10 条随机记录。参数上要注意如果 query 里没有 page模板引擎可能返回空字符串最好设默认值比如{{query.page || 1}}。这一步做不好前端拿到的分页数据就是undefined排查起来很费时间。3. 从零跑通一个一键 Mock 工具最小可用版本3.1 环境准备与依赖选择要自己实现一个最小可用的 Http 自动回复请求软件不需要复杂框架。Python 用http.server加json就能起步Node.js 用express更顺手。下面以 Python 为例因为标准库自带 HTTP 服务不用额外装包适合快速验证。# 确认 Python 版本建议 3.8 以上 python3 --version # 创建工作目录 mkdir mock-server cd mock-server # 新建规则文件和主程序 touch rules.json server.py参数说明Python 3.8 以上对http.server的并发处理更稳定如果团队用 Node.js把server.py换成server.js依赖换成express和body-parser即可。注意不要用 Python 2http.server在 Python 2 里叫BaseHTTPServer写法完全不同。3.2 规则文件设计把匹配和响应分开规则文件建议用 JSON结构清晰改起来不用动代码。下面是一个包含两条规则的示例{ rules: [ { method: GET, path: /api/user/list, response: { status: 200, body: { code: 0, data: [ { id: 1, name: 张三 }, { id: 2, name: 李四 } ] } } }, { method: POST, path: /api/user/create, response: { status: 201, body: { code: 0, message: created } } } ] }逻辑说明rules是数组按顺序匹配命中第一条就返回。参数上status默认 200创建类接口可以设 201body里直接写最终返回的 JSON 对象不要写成字符串否则前端拿到的是转义后的文本。如果规则很多建议按业务模块拆成多个文件启动时合并加载。3.3 核心服务代码监听端口、匹配规则、返回响应import json import re from http.server import BaseHTTPRequestHandler, HTTPServer from urllib.parse import urlparse, parse_qs # 加载规则文件 with open(rules.json, r, encodingutf-8) as f: RULES json.load(f)[rules] class MockHandler(BaseHTTPRequestHandler): def _match_rule(self, method, path): for rule in RULES: if rule[method] ! method: continue # 支持简单路径匹配后续可扩展正则 if rule[path] path: return rule return None def _send_response(self, rule): status rule[response].get(status, 200) body json.dumps(rule[response][body], ensure_asciiFalse) self.send_response(status) self.send_header(Content-Type, application/json; charsetutf-8) self.send_header(Access-Control-Allow-Origin, *) self.end_headers() self.wfile.write(body.encode(utf-8)) def do_GET(self): parsed urlparse(self.path) rule self._match_rule(GET, parsed.path) if rule: self._send_response(rule) else: self.send_response(404) self.end_headers() def do_POST(self): parsed urlparse(self.path) rule self._match_rule(POST, parsed.path) if rule: self._send_response(rule) else: self.send_response(404) self.end_headers() if __name__ __main__: server HTTPServer((0.0.0.0, 8080), MockHandler) print(Mock server running on http://127.0.0.1:8080) server.serve_forever()逻辑说明_match_rule按方法和路径匹配命中后调用_send_response返回 JSON。参数上0.0.0.0表示监听所有网卡局域网内其他机器也能访问端口 8080 如果被占用改成 8081 或 9090。Access-Control-Allow-Origin: *解决跨域但生产环境不要这么写。注意do_POST里没有读 Body如果规则需要按 Body 匹配要加self.rfile.read(int(self.headers[Content-Length]))。3.4 启动与验证用 curl 和 F12 各测一遍# 启动服务 python3 server.py # 另开终端测试 GET 接口 curl -X GET http://127.0.0.1:8080/api/user/list # 测试 POST 接口 curl -X POST http://127.0.0.1:8080/api/user/create \ -H Content-Type: application/json \ -d {name:王五}参数说明-X指定方法-H加 Header-d带 Body。如果 curl 返回 404先检查路径是否完全一致包括大小写和结尾斜杠。浏览器 F12 里测试时注意看 Network 面板的 Request URL 和实际请求方法很多人把 POST 写成 GET规则自然不命中。这一步跑通最小可用版本就成立了。4. 避坑与排查Mock 工具最容易翻车的五个地方4.1 现象请求返回 502但 Mock 服务日志没有记录原因请求根本没到 Mock 服务可能被系统代理或浏览器代理截走了。常见于之前配过charles或http debugger pro代理设置没清干净。解决检查系统代理设置把127.0.0.1:8080加入不走代理的列表或者临时关闭代理。用curl -v看请求实际发到了哪个地址。4.2 现象规则明明写了但返回的还是真实后端数据原因代理拦截模式下Mock 规则没命中工具按默认行为透传了。常见于路径匹配用了前缀匹配但实际请求带了 query 参数路径比对失败。解决把匹配日志打开打印每次请求的 method 和 path和规则逐条比对。如果路径带 query匹配时只取urlparse(path).path不要带?后面的内容。4.3 现象前端报the specified http method is not allowed原因Mock 服务只实现了do_GET和do_POST请求用了 PUT 或 DELETE服务返回 501。解决在 Handler 里补上do_PUT、do_DELETE或者用do_OPTIONS统一处理预检请求。注意 CORS 预检是 OPTIONS 方法不处理的话浏览器直接拦截。4.4 现象返回 JSON 里中文变成乱码原因Content-Type没带charsetutf-8或者json.dumps没加ensure_asciiFalse。解决两个地方都要改Header 写application/json; charsetutf-8序列化时加ensure_asciiFalse。用curl测试时加--header Accept-Charset: utf-8验证。4.5 现象高频请求下 Mock 返回串数据原因http 连接复用导致多个请求共用一个连接如果服务端没有正确区分每次请求的上下文可能把上一个请求的响应返回给下一个。解决在响应头加Connection: close强制短连接或者确保每次请求都重新读取规则。性能要求高时用支持并发的框架替换HTTPServer比如ThreadingHTTPServer。5. 进阶技巧让 Mock 工具从能用变成好用5.1 用场景切换管理多套返回真实联调里同一个接口可能需要返回成功、失败、空列表、超时四种情况。我一般会在规则文件里加一个scene字段通过请求头X-Mock-Scene切换。{ method: GET, path: /api/order/list, scenes: { success: { status: 200, body: { code: 0, data: [1, 2, 3] } }, empty: { status: 200, body: { code: 0, data: [] } }, error: { status: 500, body: { code: 500, message: internal error } } } }请求时加X-Mock-Scene: empty就返回空列表。参数说明默认场景设为success没传头时走默认。这样测试同学不用改代码就能验证前端对空数据和异常的处理。5.2 用延迟模拟弱网和超时前端 loading 状态、超时重试逻辑靠正常返回是测不出来的。在响应前加time.sleep(3)模拟 3 秒延迟或者直接返回 504 模拟网关超时。import time def _send_response(self, rule): delay rule[response].get(delay, 0) if delay: time.sleep(delay) # 后续返回逻辑不变参数上delay单位是秒建议设 1 到 5 之间太长会拖慢测试节奏。注意如果用了ThreadingHTTPServer延迟不会阻塞其他请求用单线程HTTPServer时一个请求延迟会卡住后面所有请求。5.3 验证 Mock 是否真的生效三个检查点第一个检查点curl -v看响应头里有没有你设置的X-Mock标记有就说明走的是 Mock。第二个检查点看 Mock 服务控制台有没有打印匹配日志没有日志说明请求没到。第三个检查点把真实后端停掉如果请求还能返回说明 Mock 生效如果报连接拒绝说明请求根本没走 Mock。这三个点按顺序查基本能定位所有“Mock 不生效”的问题。我自己的习惯是每加一条规则先用curl跑一遍再让前端调一遍最后把规则文件提交到仓库。Mock 规则也是代码不版本管理的话过两周自己都忘了当时为什么这么写。希望帮到你。本文还有配套的精品资源点击获取