简介这是一款自主研发的Http自动回复请求软件一键Mock工具专为前端开发者与接口调试人员设计可在后端接口未就绪时快速创建和管理模拟接口。软件提供直观的用户界面支持根据接口文档灵活配置请求类型、响应状态与返回数据并可通过一键启动服务立即进入调试状态从而有效消除前后端联调阻塞加快开发节奏。压缩包共包含33个文件以exe程序主体、dll运行库、xml配置与文档为主同时附有使用说明和更新说明pdf、log4net配置文件、SQLite数据库文件以及日志文件等资源整体仅5.36MB轻量易部署。目前已有490人学习使用工具无需复杂安装基于.Net Framework 4.6.2即可在Win10 x64环境直接运行。下载即可获得完整可运行程序及全部依赖项配合内置说明可快速上手显著提升接口调试与前端开发效率。1. Http自动回复请求软件是什么给联调现场准备的假后端前端等后端接口等到下班、第三方支付回调没法重复触发、测试环境登录态总是过期——这类场景里最缺的不是工具是一个「随叫随到、永远给你想要的那个响应」的假后端。标题里的 Http自动回复请求软件本质就是守在某个端口上的一个自动应答进程你给它一套规则文件它收到 HTTP 请求后按规则自动回包规则没命中时可以选择返回 404也可以把请求原样转发给真实上游。它解决的是三件事后端没就绪时前端能继续开发、不稳定的真实环境可以被固定响应替代、异常响应可以被稳定复现。适合前端联调、移动端调试、API 自动化测试以及需要模拟故障的后端开发。别把它想成 Postman 那类发请求的工具——它不发请求只负责「接住」请求所以它能真正顶替一个后端进程的角色。2. 三种 Mock 路线代理改写、独立假服务、网关分流先选对再动手动手写代码之前得先想明白一个问题你要 mock 的是「请求流经的某一段」还是「整个后端」。选错路线后面所有规则配置都会变扭。下面三条路线我都用过各自边界很清楚。2.1 代理自动响应Fiddler/Charles 的做法与局限很多人第一次接触 mock 是 Fiddler 的 Auto Responder 或 Charles 的 Map Local。原理是启动一个本机代理把请求拦下来按规则替换成本地文件或固定响应。好处是几乎不改代码抓到什么改什么规则命中情况一目了然。但它的局限也很明显。第一被测设备必须把流量指向这个代理局域网里别人要共用你的 mock 就得改自己代理设置。第二https 要装并信任根证书才能解开流量而这正是 http 和 https 的区别里最磨人的部分http 走明文怎么替换都行https 一上证书很多人的 mock 就卡在「请求没进代理」上。第三规则是 UI 里手点的多了以后没法沉淀成文件跟代码一起提交换个人电脑一切重来。所以这类工具适合临时抓包改响应不适合作为团队共用的 mock 服务。2.2 独立假服务标题里「一键Mock工具」的正解第二条路线是把 mock 做成一个真正绑定端口的进程被测程序把 baseURL 指向它。这就是标题里「一键Mock工具」最典型的形态一个可执行文件、一份规则文件、一条启动命令服务就起来了。它有几个代理模式给不了的优势。被测端不需要任何代理设置改一个 baseURL 字符串即可服务可以提交进代码库团队所有人拉下来跑同一个 mock能在 CI 里直接起一个跑接口测试时天然可重复。自动回复的语义在这里最干净有规则就回规则没规则就决定是 404 还是转发。我在实际项目里最常用它来做「后端还没写好前端按接口文档先行联调」这件事接口文档里定义的每个响应都可以提前配成规则。2.3 网关转发与代码分支什么时候用第三条路线是网关分流用 nginx 或 Kong 按路径把请求分流到 mock 服务和真实后端实现「部分接口假、部分接口真」。适合整个团队长期共用一个环境、mock 规则要统一管理的场景。也有人在客户端代码里写开关切换 baseURL简单粗暴但很容易把 mock 逻辑带进生产代码我一般不推荐。我自己的选型习惯是临时两三人联调用独立 mock 服务最快要长期维护、多人共用才值得上网关分流。标题这类工具几乎都长成「本地端口 规则文件」正是因为独立假服务在这三条路线里投入产出比最高。下面我就按这个路线带你做一版真正能用的。3. 从零写一个最小可用的自动回复服务规则文件 单文件 Python选型定了接下来落到实现。既然是「一键」工具我的要求是任何一台内网机器装过 Python 3.6 以上就能跑不依赖 pip install 任何第三方库。用标准库的http.server就能写出一个多线程的 HTTP 服务这一步省掉的是「新环境装依赖」这个最大的隐形时间成本。3.1 目录结构与零依赖设计mock/ ├── mock_server.py # 单文件服务零第三方依赖 ├── rules.json # 自动回复规则 └── README.md # 启动命令和约定为什么不直接用 Flask 或 FastAPI它们确实写起来更顺手但会引入 venv、pip install、依赖版本这三个问题。工具一旦依赖环境就谈不上「一键」。FastAPI 的优势是容易扩展管理页面如果你确定要做一个带 UI 的团队平台可以换但作为联调期的自动回复服务标准库完全够。我见过太多 mock 工具死在「换台电脑装不上依赖」上零依赖就是它最大的可靠性。3.2 规则文件 rules.json字段设计与完整示例规则文件是整个工具的「业务逻辑」。先看一份能直接用的示例再解释每个字段{ rules: [ { name: 登录接口-正常返回, method: POST, path: ^/api/login$, priority: 100, delay: 300, status: 200, headers: { Content-Type: application/json; charsetutf-8 }, body: { code: 0, message: ok, data: { token: mock_token_${timestamp}, nickname: 测试用户 } } }, { name: 订单列表-任意订单号, method: GET, path: ^/api/orders/[0-9]$, priority: 50, status: 200, body: { code: 0, data: [ { orderId: 1001, amount: 99.9, status: paid } ] } }, { name: 用户详情-按查询参数区分, method: GET, path: ^/api/user$, priority: 80, query: { id: 1 }, body: { code: 0, data: { id: 1, name: 管理员, role: admin } } } ] }字段含义method是 HTTP 方法*表示任意方法path是正则表达式作用在去掉查询参数的路径上query是查询参数匹配规则里出现的 key 必须存在且值相等priority是优先级数字大的先匹配delay是响应延迟毫秒数status是响应状态码headers是响应头body是响应体可以是字符串或对象。${timestamp}这类占位符由服务端动态替换后面章节专门讲。3.3 核心代码匹配、自动回复、未命中转发下面这份代码是完整可运行的版本直接保存为mock_server.py就能用# -*- coding: utf-8 -*- Http自动回复请求软件(Mock工具) - 单文件版 用法: python3 mock_server.py [端口] [规则文件] [上游地址] 示例: python3 mock_server.py 8080 ./rules.json http://127.0.0.1:9000 import json import os import re import sys import threading import time from datetime import datetime from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer from urllib.parse import urlparse, parse_qs RULES [] FORWARD_TO rules_lock threading.Lock() def load_rules(path): global RULES with open(path, r, encodingutf-8) as f: data json.load(f) # 规则文件允许直接是列表也可以是 {rules: [...]} 包装 rules data if isinstance(data, list) else data.get(rules, []) for r in rules: r.setdefault(priority, 0) r.setdefault(delay, 0) r[_pattern] re.compile(r[path]) # path 字段按正则预编译 rules.sort(keylambda x: x[priority], reverseTrue) with rules_lock: RULES rules print(f[mock] 已加载 {len(rules)} 条规则来源: {path}) def match_rule(method, path, query, headers): with rules_lock: rules list(RULES) for r in rules: if r.get(method, *) ! * and r[method].upper() ! method: continue if not r[_pattern].search(path): continue # 查询参数匹配只校验规则里出现的 key q_rule r.get(query, {}) if any(query.get(k) ! [v] for k, v in q_rule.items()): continue # 请求头匹配做精确相等校验 h_rule r.get(requireHeaders, {}) if any(headers.get(k) ! v for k, v in h_rule.items()): continue return r return None def render_body(template, query, req_headers, req_body): if isinstance(template, dict): template json.dumps(template, ensure_asciiFalse) now datetime.now().strftime(%Y-%m-%d %H:%M:%S) # 支持以下占位符按需替换成真实数据 template template.replace(${timestamp}, str(int(time.time() * 1000))) template template.replace(${datetime}, now) template template.replace(${body}, req_body.decode(utf-8, errorsignore)) for k in query: template template.replace(${query. k }, query[k][0]) for k in req_headers: template template.replace(${header. k }, req_headers[k]) return template.encode(utf-8) class Handler(BaseHTTPRequestHandler): protocol_version HTTP/1.1 # 启用连接复用 server_version AutoReplyMock/1.0 def do_GET(self): self._handle() def do_POST(self): self._handle() def do_PUT(self): self._handle() def do_DELETE(self): self._handle() def do_PATCH(self): self._handle() def _read_body(self): try: length int(self.headers.get(Content-Length, 0)) except ValueError: length 0 if length 0: return b return self.rfile.read(length) def _log(self, rule, status): print(f[mock] {self.command} {self.path} - f{rule if rule else FORWARD} [{status}]) def _handle(self): parsed urlparse(self.path) query parse_qs(parsed.query) req_body self._read_body() rule match_rule(self.command, parsed.path, query, self.headers) if rule is None: self._forward(parsed, req_body) return delay rule.get(delay, 0) if delay 0: time.sleep(delay / 1000.0) # delay 单位是毫秒 body render_body(rule.get(body, ), query, self.headers, req_body) status rule.get(status, 200) resp_headers rule.get(headers, {}) self.send_response(status) self.send_header(Content-Type, resp_headers.get( Content-Type, application/json; charsetutf-8)) self.send_header(Content-Length, str(len(body))) for k, v in resp_headers.items(): self.send_header(k, v) self.end_headers() self.wfile.write(body) self._log(rule.get(name, rule[path]), status) def _forward(self, parsed, req_body): if not FORWARD_TO: self.send_error(404, fno rule matched: {self.command} {parsed.path}) return import http.client u urlparse(FORWARD_TO) conn_cls http.client.HTTPSConnection if u.scheme https else http.client.HTTPConnection conn conn_cls(u.netloc, timeout5) # 过滤 hop-by-hop 头避免 Connection / Host / 长度头被原样带过去 headers { k: v for k, v in self.headers.items() if k.lower() not in ( connection, proxy-connection, keep-alive, transfer-encoding, host, content-length) } try: conn.request(self.command, parsed.path, bodyreq_body, headersheaders) resp conn.getresponse() data resp.read() self.send_response(resp.status) for k, v in resp.getheaders(): if k.lower() in (transfer-encoding, connection): continue self.send_header(k, v) self.send_header(Content-Length, str(len(data))) self.end_headers() self.wfile.write(data) self._log(UPSTREAM, resp.status) except Exception as e: # 上游不可达时给明确 502方便两端排查 body json.dumps({code: 502, message: fupstream error: {e}}, ensure_asciiFalse).encode(utf-8) self.send_response(502) self.send_header(Content-Type, application/json; charsetutf-8) self.send_header(Content-Length, str(len(body))) self.end_headers() self.wfile.write(body) self._log(UPSTREAM_ERROR, 502) finally: conn.close() def watch_rules(path): 规则文件热加载轮询 mtime变化就重新加载 last_mtime None while True: try: mtime os.path.getmtime(path) except OSError: mtime None if last_mtime is not None and mtime ! last_mtime: print([mock] 检测到规则文件变化执行热加载...) load_rules(path) last_mtime mtime time.sleep(1) if __name__ __main__: port int(sys.argv[1]) if len(sys.argv) 1 else 8080 rules_path sys.argv[2] if len(sys.argv) 2 else rules.json FORWARD_TO sys.argv[3] if len(sys.argv) 3 else load_rules(rules_path) threading.Thread(targetwatch_rules, args(rules_path,), daemonTrue).start() server ThreadingHTTPServer((0.0.0.0, port), Handler) print(f[mock] 自动回复服务已启动: http://127.0.0.1:{port}) print(f[mock] 未命中规则 {转发到 FORWARD_TO if FORWARD_TO else 返回 404}) server.serve_forever()几个关键点说一下。ThreadingHTTPServer是标准库里的多线程版 HTTP 服务器每个连接一个线程避免了单线程服务器在 http 连接复用下被慢请求堵死的问题。protocol_version HTTP/1.1明确了连接可以复用实测接口调用吞吐比默认的 HTTP/1.0 每请求断开要高出一截代价是客户端连接池会保持长连接——这个特性在后面避坑章节会变成排查重点这里先记住。match_rule里把所有规则在加载时就预编译成正则对象避免每个请求到达时现场编译。匹配顺序按priority降序同优先级保持文件内的书写顺序这个顺序约定在规则多起来之后极其重要。render_body里的占位符替换是工具的灵魂。${timestamp}换成毫秒时间戳${datetime}换成可读时间${query.xxx}取当前请求的查询参数${body}回显请求体。这样 mock 响应就不再是一潭死水能根据请求内容动态变化。3.4 启动与自测用 curl 验证三种命中情况先准备好rules.json然后启动python3 mock_server.py 8080 ./rules.json看到已加载 3 条规则和服务已启动两行日志就说明起来了。接着开三个终端分别验证# 命中精确规则POST /api/login应该有 300ms 延迟和 token curl -i -X POST http://127.0.0.1:8080/api/login \ -H Content-Type: application/json -d {account:a} # 命中带通配的正则规则任意订单号 curl -s http://127.0.0.1:8080/api/orders/9527 # 未命中任何规则默认返回 404 curl -i http://127.0.0.1:8080/api/not-exist用curl -w %{time_total}可以验证延迟是否符合预期的 300mscurl -s -o /dev/null -w 耗时: %{time_total}s\n \ -X POST http://127.0.0.1:8080/api/login -d {}到这一步一个能自动回复、能区分接口、能模拟延迟的 mock 服务就跑通了。但这只是开始规则引擎的边界、动态响应的坑、转发链路的 502才是真正会耗你一整天的地方。4. 规则引擎进阶匹配优先级、动态响应与真实转发最小版本能跑起来只是拿到了入场券。规则一多匹配顺序、动态变量、转发行为这些细节就会决定这个工具是「好用」还是「想砸电脑」。4.1 匹配优先级与正则在 path 上的边界规则的求值顺序是priority从大到小同优先级按文件内先后。这个顺序必须当成约定写进团队文档否则就会出现「明明配了特殊规则为什么不生效」的翻车现场。典型场景先用低优先级配一条兜底规则所有 GET 请求返回通用用户信息再配一条高优先级规则专门处理id1的管理员用户。优先级字段让「兜底 特例」成为可能[ { name: 通用用户, method: GET, path: ^/api/user$, priority: 10, body: { code: 0, data: { id: 0, name: default } } }, { name: 管理员用户, method: GET, path: ^/api/user$, priority: 80, query: { id: 1 }, body: { code: 0, data: { id: 1, name: admin } } } ]再强调一下 path 是正则有三个实战坑。第一^和$别乱省不写$的话^/api/orders会把/api/orders/123和/api/orders_old都命中。第二路径里的点号要转义^/api/v1.1/里的点如果不写成\.它会匹配任意字符规则会在一些意想不到的路径上生效。第三匹配用的是re.search而不是re.match这意味规则里的 pattern 不必从路径头部开始也能命中习惯写^开头能减少很多困惑。正则写完建议先用一小段 Python 验证再放进规则文件不要直接梭哈。4.2 动态响应变量时间戳、查询参数、请求头回显自动回复不等于死数据。联调时最常见的需求是「token 每次不一样」「响应里回显我传的参数」。render_body里的占位符就是为这个准备的完整支持列表如下占位符含义示例${timestamp}毫秒时间戳1691234567890${datetime}可读时间2024-08-01 12:00:00${body}回显请求体原文{account:a}${query.xxx}查询参数 xxx/api/user?id1时替换为 1${header.xxx}请求头 xxx${header.Authorization}注意占位符里 key 的大小写要和实际一致请求头在标准库里会原样保留大小写所以取${header.content-type}和${header.Content-Type}的结果是不同的。这是个容易忽略的细节。这里有一个安全相关的点必须提如果规则里把${header.xxx}或${body}直接拼进响应而请求方传来的值里带了换行符响应头就可能被污染这就是典型的 http 头注入场景。我们自己的 mock 虽然只在内网跑但一旦接入外部输入最好在render_body里对替换结果做一次\r和\n的剔除成本一行能省掉被人拼接恶意头的麻烦。4.3 未命中规则时把请求转发到真实上游第三种匹配结果是不命中处理方式决定了 mock 能否「优雅地部分生效」。启动时加上第三个参数就是上游地址python3 mock_server.py 8080 ./rules.json http://127.0.0.1:9000这样 mock 只接管配置了规则的接口其余请求透明转发到 9000 端口的真实服务。联调时这个模式尤其好用后端只写好了登录接口其他接口先转发到测试环境两边都不用等。转发实现里有三个细节值得注意。一是要过滤Connection、Host、Content-Length、Transfer-Encoding这类 hop-by-hop 头否则把本机连接的 Host 头原样带给上游上游可能因为 Host 不匹配直接拒绝。二是上游是 https 时启动参数一定要显式写https://前缀代码里靠 scheme 决定用HTTPSConnection还是HTTPConnection写错就握手失败。三是连接超时固定了 5 秒上游慢时 mock 会先返回 502 而不是无限等这个行为让调用方能快速感知问题而不是客户端先超时。4.4 热加载改规则不用重启进程规则文件改动后不用重启进程靠的是后台线程每秒轮询文件 mtime。这让「改一个响应体 → 立刻重放请求验证」的循环从十几秒压缩到两三秒联调体验完全不一样。实际使用时注意两点第一某些编辑器保存文件时是先写临时文件再原子替换这种情况下getmtime依然会变化热加载能正常触发。第二启动参数里的规则文件路径如果是相对路径而进程的工作目录和你想的不一样热加载会盯着一个不存在的文件日志里完全没有「检测到规则文件变化」的输出。排查手段很直接启动时打印一遍os.path.abspath(rules_path)确认路径比瞎猜快得多。规则文件的 JSON 解析失败时load_rules会抛异常把整个进程打挂生产中建议再加一层 try 把错误打印成「规则文件第几行有问题」再继续跑旧规则这是成熟的 mock 工具都会做的容错。5. 避坑Mock 不生效、502、超时五个常见问题排查工具写过、跑通真正磨人的是上线后的「不生效」。这一章把我在实战里踩过的五类高频问题按「现象 → 原因 → 解决」列清楚每一条都对应一种真实翻车现场。5.1 Fiddler mock 响应数据不生效先怀疑连接复用现象在 Fiddler 的 Auto Responder 里配好了规则第一请求生效了把响应改成新数据后客户端拿到的一直是旧值甚至完全不进规则。原因这类代理工具只能改「经过它」的请求。两个最常见的坑是客户端根本没走代理请求直连了目标 IP或者走了代理但连接被复用客户端进程和服务端之间的 http 连接保持不释放后续请求不重新走规则匹配流程。连接复用是最容易忽略的——你以为是规则问题其实是连接池把旧响应「缓存」了。解决先确认客户端确实通过代理发起请求看 Fiddler 会话列表里有没有这个请求有的话改规则后让客户端断开连接重试或者直接重启客户端进程。如果你最终目的是稳定 mock我的建议是别在代理工具上死磕把 baseURL 指向独立 mock 服务连接复用问题立刻消失这也是标题这类工具存在的意义。5.2 转发链路报 502 Bad Gateway上游地址与协议不一致现象mock 收到请求日志里出现UPSTREAM_ERROR 502客户端看到unexpected status 502 bad gateway: unknown error这类报错。原因转发时最常见的原因是上游地址写错、上游服务没起、上游端口不对。还有一个特别隐蔽的上游实际是 https但启动参数里写了http://HTTPConnection和它做明文握手上游直接拒绝连接表现为 502 而不是超时。另外上游要求特定的Host或Authorization头而我们过滤了 Host 又没在转发头里补充也会触发上游网关的 502。解决先绕过 mock 直接 curl 上游地址确认上游本身可用再检查启动参数里的 schema 是http://还是https://最后打开 mock 的转发日志看实际带过去的头列表。我们实现的_forward在异常时会把异常信息拼进返回体upstream error: ...这半句话就是全链路最直接的排查入口。5.3 改了规则文件没动静缓存与热加载的玄学现象编辑rules.json保存请求发过去响应还是旧内容日志里也没有「检测到规则文件变化」。原因三个方向排查。一是热加载线程盯着的路径不对确认abspath和实际编辑的文件是同一个。二是有些编辑器或 IDE 的自动保存 远程同步组合会让 mtime 出现「看起来变了但其实没变」的情况极少数文件系统下 1 秒轮询可能刚好错过。三是客户端自己做了超时重试或本地缓存你以为服务没更新其实是调用方拿的旧响应。解决修改后手动touch rules.json触发一次 mtime 变化观察服务端是否打印热加载日志先锁定是服务端还是客户端的问题。想要更可靠可以给规则文件加一个version字段每次热加载把它打印出来客户端对比版本号就知道自己拿的是哪一版数据。5.4 中文乱码与 Content-Type 头缺失现象响应里的中文变成了一串\uXXXX转义或者浏览器/Postman 显示乱码。原因规则里body写成 JSON 对象时代码用json.dumps序列化如果不指定ensure_asciiFalse中文会被转义成\uXXXX的 ASCII 形式。另一个场景是响应头里没有明确的 charset客户端拿 UTF-8 的字节流按 ISO-8859-1 解必然乱码。解决render_body里已经用了ensure_asciiFalse规则文件本身保存为 UTF-8 编码即可。响应头没指定 charset 时代码默认会给application/json; charsetutf-8自定义响应头时记得带上 charset。检查规则里headers字段是否覆盖了默认值如果覆盖后漏了 charset恰好踩中这个坑。顺手排查方法curl -i看响应头再echo body | iconv -f utf-8 -t utf-8确认字节流本身没问题。5.5 客户端「连接超时」延迟、线程与 keep-alive 的锅现象单个请求正常一旦并发或压测客户端批量报connection timed out或timeout was reached。原因第一规则里delay配得过大比如响应延迟 5 秒客户端超时设置只有 3 秒必挂。第二ThreadingHTTPServer虽然每个连接一个线程但延迟期间线程是阻塞的并发一大线程和 socket 句柄被打满。第三protocol_version HTTP/1.1开了连接复用客户端连接池里的连接在服务端假死时会一直被占用直到操作系统超时才发现。解决先用curl -w %{time_total}量出真实响应耗时确认是不是 delay 超过客户端阈值把固定 delay 改成小范围的随机延迟避免所有请求同时堵住确认客户端连接池的最大连接数和空闲超时设置和 mock 的延迟量级匹配。还有一个实用习惯压测前先看 mock 进程的线程数和句柄数涨到几千不回落基本就是延迟注入把线程池拖垮了。6. 让 Mock 更像真实环境延迟抖动、故障注入与录制回放到这步工具已经稳定可用了最后一层是把它从「假得明显」变成「假得专业」。三个进阶用法是我觉得性价比最高的。第一是延迟抖动。真实网络延迟不是固定值而是有波动的。把规则里的delay从固定数字扩展成[50,300]这样的区间加载时随机取值能让联调更早暴露超时问题。实现上在load_rules里加几行判断即可命中规则时用random.randint生成延迟。这个改动成本极低但能让 mock 的真实感上一个台阶。第二是故障注入。给规则配上status: 500、status: 503甚至让请求挂起直到超时用来验证客户端的重试、降级和熔断逻辑。这里有个实战经验用feign.FeignException: [500] during [get] to ...去检索问题的同事有一大半其实是在故意测故障注入服务端报 500 是预期行为不用慌。真正要验证的是客户端收到 500 后有没有按预期走重试策略。故障注入的规则建议单独放一个fault-rules.json和正常规则分开管理避免开错。第三是录制回放。这是把 mock 工具变成资产的关键一步在代理模式下把真实请求和响应录制下来自动生成rules.json之后离线就能重放。这样线上某个接口的复杂响应可以被沉淀成回归用例每次发版前用 mock 跑一遍。实现思路是先记录请求指纹method path query 关键 header再把响应体存成规则命中时直接返回。真实响应里的动态字段时间戳、token会自动落入${timestamp}这类占位符的替换逻辑所以录制出来的规则本身就能保持动态性。我的使用习惯是每个规则必须写name日志里有名字才知道哪条在生效rules.json纳入 git接口文档变更时同步更新遇到「不生效」第一件事清调用方连接池而不是改规则这救过我很多次。以上是这套方案的全部落地过程。mock 工具的终点不是替代真实后端而是让联调这件事从「等别人」变成「自己说了算」希望帮到你。本文还有配套的精品资源点击获取