简介面向前端开发与接口联调场景的Http自动回复请求软件一键Mock工具专为解决后端接口未完成导致的前端开发阻塞问题适合前后端并行项目中的开发、测试及接口调测人员无需深入后端知识即可快速上手既能支撑日常调试也可用于接口演示与教学。软件支持根据接口文档录入URL、请求方式与返回数据通过直观界面完成mock接口的创建、编辑与管理并支持设置响应状态和返回内容方便模拟多种业务场景。压缩包内共33个文件以exe主程序为核心配套dll运行库、xml/config配置文件、pdf说明文档、log日志及数据库db文件其中dll封装核心依赖xml与config用于参数调整pdf提供操作指引log记录详细运行日志db作为本地数据库保存mock数据整体仅5.36MB免安装即可启动。一键启动后工具会自动回复HTTP请求实现即时接口联调和数据模拟测试同时支持多套配置保存与加载便于不同项目间快速切换使用。当前已有488人学习下载可显著缩短接口等待时间提升前后端协作开发效率。1. 一键 Mock 工具把 Http 自动回复做成了桌面服务前端联调卡在后端接口未完成是让人最耗时间的场景之一。常见的做法是临时起一个 Node/Express 服务写一堆 mock 路由接口一多就难以维护。这里拆解的是一款 Http 自动回复请求软件一键 Mock 工具Windows 下双击运行按接口文档在界面里配置状态码、响应体和匹配规则保存后一键启动服务即可对外提供模拟接口。它的核心能力是把一条条接口规则变成 Http 请求的自动回复支持精确路径、正则匹配和参数提取规则持久化在本地 SQLite 数据库中。适合前端开发、联调测试以及需要快速验证回调场景的全栈工程师——不需要安装插件不依赖 Node/Python 环境直接在 Win10 x64 上跑。2. 自动回复链路与依赖库拆解从 HttpListener 到 SQLite 规则库要理解这类一键 Mock 工具先要清楚它在执行什么逻辑软件在本地开启一个 Http 监听端口收到请求后读取请求的方法、路径、Header 和 Body与预先配置的匹配规则逐条比对命中后按规则描述的响应内容返回没有命中时可以选择把请求转发到真实后端地址。这套逻辑和 Charles 的 Map Local / Map Remote 类似只是把配置过程从抓包工具里搬到了专门的桌面应用中。2.1 请求拦截、匹配与响应的完整链路软件叫自动回复实际工作流是三层结构。第一层是 Http 请求监听模块。考虑到 .NET Framework 4.6.2 运行环境这里最可能的做法是使用 HttpListener 或自建 TcpListener 解析裸协议。HttpListener 的优势是自带 Http 报文解析直接拿到 Request 和 Response 对象省去处理 Keep-Alive、分块传输等底层细节。多客户端连接时HttpListener 会按请求建立独立上下文这也是它能支持“http连接复用”的原因——多个调用端可以同时对同一个 Mock 服务发起请求互不阻塞。第二层是规则匹配模块。每条规则至少包含 Http 方法、请求路径、响应体和响应状态码部分规则还会包含正则表达式用于限定 Header 或 Body 中的关键参数。匹配过程是线性遍历的因此规则顺序影响命中结果精确规则放在前面宽泛规则放在后面否则前置的/api/user正则会把/api/user/list的请求提前吞掉。第三层是响应输出模块。软件返回 Mock 数据时按规则配置的 Content-Type 输出常见的有application/json、text/html、text/plain。如果配置了延迟时间软件会在回复前做线程等待用来模拟接口慢响应这在联调超时和骨架屏场景中很实用。2.2 关键依赖库的职责边界解压包里有一批运行库能直接看出软件的技术选型挑四个重点说明。第一条线是日志组件 log4net。log4net.config定义了日志输出到文件还是控制台以及日志级别。排错时把级别调成 Debug可以看到启动失败或匹配异常的具体原因否则很多 HTTP 500 只会留下一条笼统错误root level valueDEBUG / appender-ref refRollingFileAppender / /rootlevel value支持 DEBUG / INFO / WARN / ERROR 四档。平时用 INFO 减少写入量遇到问题时切到 DEBUG重启软件后观察新增日志。参数说明RollingFileAppender表示按日期滚动生成文件避免单个日志文件无限膨胀。第二条线是数据持久化组件 EntityFramework 与 System.Data.SQLite。DataServer.db是全部 Mock 规则的存储库界面增删改查接口时通过 EF 映射操作 SQLite。SQLite 单文件数据库的好处是规则可以整体拷贝团队间同步 Mock 配置只传一个文件即可。第三条线是 JSON 解析组件 Newtonsoft.Json。响应体模板中的 JSON 文本、请求参数提取、响应数据动态替换都靠它处理。如果配置的响应体本身是非法 JSON软件在回复时会报错或返回空内容这是使用过程中的高频踩坑点。第四条线是 MQTTnet.dll。从依赖看作者为协议扩展预留了空间MQTTnet 在 .NET 生态里专门处理 MQTT 通信。当前版本主线是 Http 自动回复日常使用不会调用它但保留这个包说明软件并非只服务于 Http 场景后面章节会展开讲扩展方向。2.3 配置文件与规则库的对应关系软件目录下的HttpAutoResponseMessage.exe.config保存了启动时读取的参数重点是服务端口和数据库路径。根目录里的DataServer.db是规则库x64与x86两个子目录下的SQLite.Interop.dll对应不同系统位数Win10 x64 环境下软件会自动加载 x64 版本。文件作用排错关注点HttpAutoResponseMessage.exe主程序是否被安全软件误拦截DataServer.dbMock 规则存储库被占用会导致保存失败HttpAutoResponseMessage.exe.config端口、数据库路径等启动参数端口是否与业务冲突log4net.config日志级别与输出方式排错时改为 DEBUGSQLite.Interop.dllx64/x86SQLite 原生驱动位数不匹配会启动失败提示DataServer.db 是规则数据唯一的持久化位置升级版本前先备份这个文件避免新版本覆盖后旧规则全部丢失。3. 从零创建一个 Mock 接口配置、验证与正则匹配按“创建/api/user/info接口返回一个 JSON 用户信息”为例完整走一遍配置、启动、验证流程。3.1 解压启动与首次初始化把压缩包解压到D:\tools\HttpAutoResponse双击HttpAutoResponseMessage.exe。第一次启动时软件会在当前目录创建或连接DataServer.db如果数据库缺少部分数据表程序会自动执行 EF 迁移完成建表这个过程会写入日志。如果双击后没有反应优先检查两处一是软件是否被 Windows Defender 或其他安全软件拦截加入信任目录后重新解压二是监听地址如果不是 127.0.0.1HttpListener 在绑定时会触发权限检查此时需要右键“以管理员身份运行”。另一个细节是目录路径不要带中文或空格部分版本的 SQLite 原生驱动在中文路径下会抛Unable to open database file换到纯英文目录基本能解决。3.2 配置接口路径、方法与响应体启动后进入主界面新建一条规则配置以下字段。这里给出一份通用规则数据实际界面按此录入即可{ ruleName: 查询用户信息, method: GET, url: /api/user/info, matchType: exact, responseCode: 200, responseHeader: { Content-Type: application/json; charsetutf-8 }, responseBody: {\code\:0,\data\:{\id\:1024,\name\:\mock-user\,\role\:\admin\}}, delay: 0 }核心字段是matchType。exact 表示路径完全一致才命中prefix 表示路径前缀匹配url 配置/api/user/时/api/user/list同样命中regex 表示用正则表达式匹配完整请求路径。responseBody是纯字符串存的就是按下表规则配置的原始文本软件不会做格式化。匹配模式匹配逻辑典型场景exact请求路径与 url 完全一致固定详情页接口prefix请求路径以 url 开头列表页、多子资源regex请求路径满足正则表达式动态 ID 详情页保存规则后点击启动服务软件在默认端口监听启动日志会打印监听地址例如http://127.0.0.1:18080/。提示url 配置以/开头不要写成 http:// 开头的完整地址软件内部会拼接监听地址与规则路径。3.3 用命令验证匹配是否生效用 curl 发起一次真实请求验证软件是否正确回复curl -i http://127.0.0.1:18080/api/user/info期望返回HTTP/1.1 200响应体是刚配置的 JSON。如果返回 404检查规则路径里是否带空格、请求地址是否大小写一致。HttpListener 对路径默认区分大小写接口文档里把/API/User/Info写大写请求用小写就会出现“规则明明配了却不生效”的假象。再验证正则匹配。把规则改成matchTyperegexurl 设置为/api/user/[0-9]{4}保存后请求curl -i http://127.0.0.1:18080/api/user/2048这条请求同样命中。正则匹配模式下响应体里可以写${id}占位符软件会把正则捕获的 2048 替换进响应体。这个能力在做翻页、详情这类动态参数的接口时一套规则能覆盖几百个不同 ID 的请求。4. 一键启动的底层逻辑与端口排错Http 服务为什么不起来“明明点了启动但浏览器访问就失败”这类问题在 Mock 工具中占比最高。下面从服务启动链路出发把可能出问题的节点逐个拆开。4.1 一键启动时程序做了什么点击启动按钮后程序依次做三件事初始化 HttpListener 并绑定监听前缀、打开 SQLite 连接加载规则、把监听状态同步到界面。绑定监听前缀时程序会检查所选端口是否被其他进程占用如果被占用初始化直接抛异常界面上表现为“启动失败”或按钮无反应。这类工具默认监听127.0.0.1只允许本机访问。如果需要局域网内其他机器调用 Mock 接口要把监听地址改为0.0.0.0或局域网 IP同时确认 Windows 防火墙放行了对应端口。放行操作可以在控制面板的防火墙高级设置里新建入站规则只开放该 TCP 端口即可。4.2 端口冲突的定位与解决用系统命令查看端口占用netstat -ano | findstr 18080输出里如果存在 LISTENING 状态的记录记下最后一列的 PID再查对应进程tasklist | findstr PID如果占用者是其他开发工具在软件配置界面把端口改掉保存后重启服务即可。如果占用者是上一次异常退出的 HttpAutoResponseMessage 残留进程直接结束进程再启动taskkill /PID PID /F/F是强制结束。注意kill 前确认该 PID 不是系统服务误杀系统进程会导致网络配置异常。4.3 从日志定位启动与运行异常log4net 的日志输出路径在log4net.config中定义。排错时把级别调到 DEBUG重启软件后日志目录会生成详细记录包含监听绑定、规则加载、请求命中整个过程。运行期常见错误分三类第一类是绑定异常日志出现Access Denied说明监听地址不是 localhost需要管理员权限运行。第二类是数据库异常日志出现database is locked说明DataServer.db被其他进程锁定检查是否用数据库工具打开了该文件。第三类是响应异常日志出现序列化错误且返回空内容说明responseBody不是合法 JSON。现象日志关键词处理方式启动后端口未监听Address already in use换端口或释放占用规则保存失败database is locked关闭占用 db 的进程返回空内容Error serializing response检查响应体 JSON 合法性提示修改 exe.config 里的端口时要同时确认界面里的端口设置没有被覆盖部分版本以界面配置优先。5. 前端工程接入 Mock 的两种姿势代理指向与域名映射工具配置完成后如何让前端工程调用这台 Mock 服务是接入环节的关键。这里给出最常见、侵入性最小的两种方式并说明各自边界。5.1 在 Webpack / Vite 中把接口代理到 Mock 地址前端工程默认把请求发往同源地址在开发服务器配置代理后可以让/api前缀的请求转发到本机 Mock 端口。以 Vite 为例在vite.config.js中添加server: { proxy: { /api: { target: http://127.0.0.1:18080, changeOrigin: true, rewrite: (path) path.replace(/^\/api/, /api) } } }target指向 Mock 服务监听地址changeOrigin为 true 时代理转发请求会把 Host 头改成目标地址避免后端识别 Host 出错rewrite在这里保留/api前缀因为 Mock 规则里配置的路径就是/api开头。如果规则里配置的是/mock/api则 rewrite 应改为path.replace(/^\/api/, /mock/api)。这样配置后前端代码里的请求路径不需要改一行/api/user/info发出的请求会被开发服务器自动转发到 Mock 服务。注意代理只在开发服务器这一层生效生产构建不受影响。另一个容易被忽略的点代理配置只应该在开发环境生效。常见误用是把vite.config.js里的 proxy 配置直接带入生产构建导致线上接口也指向127.0.0.1。建议用环境变量区分开发与构建阶段生产分支不要加载 proxy 配置。5.2 用 hosts 指定端口模拟真实域名环境部分场景下前端代码会把接口地址写死成https://api.shop.example.com此时可以改本地 hosts 文件做域名映射127.0.0.1 api.shop.example.comMock 服务监听地址保持127.0.0.1端口 18080请求地址写成http://api.shop.example.com:18080/api/user/info时DNS 解析落到本机请求进入 Mock 服务。这种方式适合验证 CORS 跨域、Cookie 作用域与生产域名强绑定的项目。需要补充的是联调时模拟慢接口同样重要。软件支持在规则里配置 delay设置 3000ms 后前端可以观察到 loading 态、超时提示的真实表现比在代码里 sleep 更贴近生产环境。5.3 请求参数匹配与多场景响应很多 Mock 场景要求同一个接口根据参数返回不同内容。常见做法是在响应体里写${param.xxx}形式的占位符程序在请求到达时从 QueryString 或 POST Body 中提取对应值并替换。例如请求/api/order?id1001响应体里的id:${param.id}会被替换成1001一套规则就能模拟多种数据。实际业务中列表页场景最常用真实接口包含pageSize、pageNum、keyword三个参数规则里全部用占位符接收返回数据量随参数变化复用一个规则就能覆盖多个测试用例相比固定 JSON 的维护成本低很多。6. 规则库迁移与扩展把 DataServer.db 变成团队 Mock 资产最后说一个能立刻提升效率的技巧利用DataServer.db的单文件特性做规则库迁移。6.1 规则库备份与多人共用关闭软件把DataServer.db复制一份发给同事对方放入相同目录并重启软件全部接口规则就同步过去了。团队协作时可以在统一目录下维护一个 baseline 模板库新成员入职直接替换数据库文件不用在界面上逐个配置接口成本几乎为零。如果规则库越来越大可以把它提交到 Git 仓库作为团队资产但要注意提交前先确认软件已退出避免数据库内存在未落盘的缓冲数据。6.2 用 SQLite 命令批量核对规则规则量大的时候在界面上翻找效率太低可以用 SQLite 命令行工具打开数据库做批量检查sqlite3 DataServer.db .tables sqlite3 DataServer.db SELECT method, url, matchType, responseCode FROM MockRule LIMIT 50;.tables列出所有表确认规则表名SELECT 语句按需统计规则数量与匹配类型分布适合在规则库膨胀后做治理。换机器排查问题时这条命令比在界面上逐条核对快得多。6.3 扩展方向与边界依赖包里包含 MQTTnet.dll软件在 Http 之外预留了 MQTT 协议模拟的扩展空间。沿用“规则表 自动回复”的模型后续版本支持 MQTT 消息模拟是顺理成章的事。当前版本主线仍是 Http 自动回复不建议把 Mock 服务当成正式接口网关它解决的是联调阶段“接口未就绪”的问题鉴权体系和稳定性不是这类工具的设计目标。规则设计上把可复用放在优先级前列响应体统一用占位符而不是硬编码便于切换环境每个接口至少留一条错误码响应规则500、429方便前端调试异常分支把公共响应头独立维护新增规则时直接复用避免每条规则重复配置同样内容。本文还有配套的精品资源点击获取
接口Mock工具解析：自动回复、正则匹配与前端联调提效
简介面向前端开发与接口联调场景的Http自动回复请求软件一键Mock工具专为解决后端接口未完成导致的前端开发阻塞问题适合前后端并行项目中的开发、测试及接口调测人员无需深入后端知识即可快速上手既能支撑日常调试也可用于接口演示与教学。软件支持根据接口文档录入URL、请求方式与返回数据通过直观界面完成mock接口的创建、编辑与管理并支持设置响应状态和返回内容方便模拟多种业务场景。压缩包内共33个文件以exe主程序为核心配套dll运行库、xml/config配置文件、pdf说明文档、log日志及数据库db文件其中dll封装核心依赖xml与config用于参数调整pdf提供操作指引log记录详细运行日志db作为本地数据库保存mock数据整体仅5.36MB免安装即可启动。一键启动后工具会自动回复HTTP请求实现即时接口联调和数据模拟测试同时支持多套配置保存与加载便于不同项目间快速切换使用。当前已有488人学习下载可显著缩短接口等待时间提升前后端协作开发效率。1. 一键 Mock 工具把 Http 自动回复做成了桌面服务前端联调卡在后端接口未完成是让人最耗时间的场景之一。常见的做法是临时起一个 Node/Express 服务写一堆 mock 路由接口一多就难以维护。这里拆解的是一款 Http 自动回复请求软件一键 Mock 工具Windows 下双击运行按接口文档在界面里配置状态码、响应体和匹配规则保存后一键启动服务即可对外提供模拟接口。它的核心能力是把一条条接口规则变成 Http 请求的自动回复支持精确路径、正则匹配和参数提取规则持久化在本地 SQLite 数据库中。适合前端开发、联调测试以及需要快速验证回调场景的全栈工程师——不需要安装插件不依赖 Node/Python 环境直接在 Win10 x64 上跑。2. 自动回复链路与依赖库拆解从 HttpListener 到 SQLite 规则库要理解这类一键 Mock 工具先要清楚它在执行什么逻辑软件在本地开启一个 Http 监听端口收到请求后读取请求的方法、路径、Header 和 Body与预先配置的匹配规则逐条比对命中后按规则描述的响应内容返回没有命中时可以选择把请求转发到真实后端地址。这套逻辑和 Charles 的 Map Local / Map Remote 类似只是把配置过程从抓包工具里搬到了专门的桌面应用中。2.1 请求拦截、匹配与响应的完整链路软件叫自动回复实际工作流是三层结构。第一层是 Http 请求监听模块。考虑到 .NET Framework 4.6.2 运行环境这里最可能的做法是使用 HttpListener 或自建 TcpListener 解析裸协议。HttpListener 的优势是自带 Http 报文解析直接拿到 Request 和 Response 对象省去处理 Keep-Alive、分块传输等底层细节。多客户端连接时HttpListener 会按请求建立独立上下文这也是它能支持“http连接复用”的原因——多个调用端可以同时对同一个 Mock 服务发起请求互不阻塞。第二层是规则匹配模块。每条规则至少包含 Http 方法、请求路径、响应体和响应状态码部分规则还会包含正则表达式用于限定 Header 或 Body 中的关键参数。匹配过程是线性遍历的因此规则顺序影响命中结果精确规则放在前面宽泛规则放在后面否则前置的/api/user正则会把/api/user/list的请求提前吞掉。第三层是响应输出模块。软件返回 Mock 数据时按规则配置的 Content-Type 输出常见的有application/json、text/html、text/plain。如果配置了延迟时间软件会在回复前做线程等待用来模拟接口慢响应这在联调超时和骨架屏场景中很实用。2.2 关键依赖库的职责边界解压包里有一批运行库能直接看出软件的技术选型挑四个重点说明。第一条线是日志组件 log4net。log4net.config定义了日志输出到文件还是控制台以及日志级别。排错时把级别调成 Debug可以看到启动失败或匹配异常的具体原因否则很多 HTTP 500 只会留下一条笼统错误root level valueDEBUG / appender-ref refRollingFileAppender / /rootlevel value支持 DEBUG / INFO / WARN / ERROR 四档。平时用 INFO 减少写入量遇到问题时切到 DEBUG重启软件后观察新增日志。参数说明RollingFileAppender表示按日期滚动生成文件避免单个日志文件无限膨胀。第二条线是数据持久化组件 EntityFramework 与 System.Data.SQLite。DataServer.db是全部 Mock 规则的存储库界面增删改查接口时通过 EF 映射操作 SQLite。SQLite 单文件数据库的好处是规则可以整体拷贝团队间同步 Mock 配置只传一个文件即可。第三条线是 JSON 解析组件 Newtonsoft.Json。响应体模板中的 JSON 文本、请求参数提取、响应数据动态替换都靠它处理。如果配置的响应体本身是非法 JSON软件在回复时会报错或返回空内容这是使用过程中的高频踩坑点。第四条线是 MQTTnet.dll。从依赖看作者为协议扩展预留了空间MQTTnet 在 .NET 生态里专门处理 MQTT 通信。当前版本主线是 Http 自动回复日常使用不会调用它但保留这个包说明软件并非只服务于 Http 场景后面章节会展开讲扩展方向。2.3 配置文件与规则库的对应关系软件目录下的HttpAutoResponseMessage.exe.config保存了启动时读取的参数重点是服务端口和数据库路径。根目录里的DataServer.db是规则库x64与x86两个子目录下的SQLite.Interop.dll对应不同系统位数Win10 x64 环境下软件会自动加载 x64 版本。文件作用排错关注点HttpAutoResponseMessage.exe主程序是否被安全软件误拦截DataServer.dbMock 规则存储库被占用会导致保存失败HttpAutoResponseMessage.exe.config端口、数据库路径等启动参数端口是否与业务冲突log4net.config日志级别与输出方式排错时改为 DEBUGSQLite.Interop.dllx64/x86SQLite 原生驱动位数不匹配会启动失败提示DataServer.db 是规则数据唯一的持久化位置升级版本前先备份这个文件避免新版本覆盖后旧规则全部丢失。3. 从零创建一个 Mock 接口配置、验证与正则匹配按“创建/api/user/info接口返回一个 JSON 用户信息”为例完整走一遍配置、启动、验证流程。3.1 解压启动与首次初始化把压缩包解压到D:\tools\HttpAutoResponse双击HttpAutoResponseMessage.exe。第一次启动时软件会在当前目录创建或连接DataServer.db如果数据库缺少部分数据表程序会自动执行 EF 迁移完成建表这个过程会写入日志。如果双击后没有反应优先检查两处一是软件是否被 Windows Defender 或其他安全软件拦截加入信任目录后重新解压二是监听地址如果不是 127.0.0.1HttpListener 在绑定时会触发权限检查此时需要右键“以管理员身份运行”。另一个细节是目录路径不要带中文或空格部分版本的 SQLite 原生驱动在中文路径下会抛Unable to open database file换到纯英文目录基本能解决。3.2 配置接口路径、方法与响应体启动后进入主界面新建一条规则配置以下字段。这里给出一份通用规则数据实际界面按此录入即可{ ruleName: 查询用户信息, method: GET, url: /api/user/info, matchType: exact, responseCode: 200, responseHeader: { Content-Type: application/json; charsetutf-8 }, responseBody: {\code\:0,\data\:{\id\:1024,\name\:\mock-user\,\role\:\admin\}}, delay: 0 }核心字段是matchType。exact 表示路径完全一致才命中prefix 表示路径前缀匹配url 配置/api/user/时/api/user/list同样命中regex 表示用正则表达式匹配完整请求路径。responseBody是纯字符串存的就是按下表规则配置的原始文本软件不会做格式化。匹配模式匹配逻辑典型场景exact请求路径与 url 完全一致固定详情页接口prefix请求路径以 url 开头列表页、多子资源regex请求路径满足正则表达式动态 ID 详情页保存规则后点击启动服务软件在默认端口监听启动日志会打印监听地址例如http://127.0.0.1:18080/。提示url 配置以/开头不要写成 http:// 开头的完整地址软件内部会拼接监听地址与规则路径。3.3 用命令验证匹配是否生效用 curl 发起一次真实请求验证软件是否正确回复curl -i http://127.0.0.1:18080/api/user/info期望返回HTTP/1.1 200响应体是刚配置的 JSON。如果返回 404检查规则路径里是否带空格、请求地址是否大小写一致。HttpListener 对路径默认区分大小写接口文档里把/API/User/Info写大写请求用小写就会出现“规则明明配了却不生效”的假象。再验证正则匹配。把规则改成matchTyperegexurl 设置为/api/user/[0-9]{4}保存后请求curl -i http://127.0.0.1:18080/api/user/2048这条请求同样命中。正则匹配模式下响应体里可以写${id}占位符软件会把正则捕获的 2048 替换进响应体。这个能力在做翻页、详情这类动态参数的接口时一套规则能覆盖几百个不同 ID 的请求。4. 一键启动的底层逻辑与端口排错Http 服务为什么不起来“明明点了启动但浏览器访问就失败”这类问题在 Mock 工具中占比最高。下面从服务启动链路出发把可能出问题的节点逐个拆开。4.1 一键启动时程序做了什么点击启动按钮后程序依次做三件事初始化 HttpListener 并绑定监听前缀、打开 SQLite 连接加载规则、把监听状态同步到界面。绑定监听前缀时程序会检查所选端口是否被其他进程占用如果被占用初始化直接抛异常界面上表现为“启动失败”或按钮无反应。这类工具默认监听127.0.0.1只允许本机访问。如果需要局域网内其他机器调用 Mock 接口要把监听地址改为0.0.0.0或局域网 IP同时确认 Windows 防火墙放行了对应端口。放行操作可以在控制面板的防火墙高级设置里新建入站规则只开放该 TCP 端口即可。4.2 端口冲突的定位与解决用系统命令查看端口占用netstat -ano | findstr 18080输出里如果存在 LISTENING 状态的记录记下最后一列的 PID再查对应进程tasklist | findstr PID如果占用者是其他开发工具在软件配置界面把端口改掉保存后重启服务即可。如果占用者是上一次异常退出的 HttpAutoResponseMessage 残留进程直接结束进程再启动taskkill /PID PID /F/F是强制结束。注意kill 前确认该 PID 不是系统服务误杀系统进程会导致网络配置异常。4.3 从日志定位启动与运行异常log4net 的日志输出路径在log4net.config中定义。排错时把级别调到 DEBUG重启软件后日志目录会生成详细记录包含监听绑定、规则加载、请求命中整个过程。运行期常见错误分三类第一类是绑定异常日志出现Access Denied说明监听地址不是 localhost需要管理员权限运行。第二类是数据库异常日志出现database is locked说明DataServer.db被其他进程锁定检查是否用数据库工具打开了该文件。第三类是响应异常日志出现序列化错误且返回空内容说明responseBody不是合法 JSON。现象日志关键词处理方式启动后端口未监听Address already in use换端口或释放占用规则保存失败database is locked关闭占用 db 的进程返回空内容Error serializing response检查响应体 JSON 合法性提示修改 exe.config 里的端口时要同时确认界面里的端口设置没有被覆盖部分版本以界面配置优先。5. 前端工程接入 Mock 的两种姿势代理指向与域名映射工具配置完成后如何让前端工程调用这台 Mock 服务是接入环节的关键。这里给出最常见、侵入性最小的两种方式并说明各自边界。5.1 在 Webpack / Vite 中把接口代理到 Mock 地址前端工程默认把请求发往同源地址在开发服务器配置代理后可以让/api前缀的请求转发到本机 Mock 端口。以 Vite 为例在vite.config.js中添加server: { proxy: { /api: { target: http://127.0.0.1:18080, changeOrigin: true, rewrite: (path) path.replace(/^\/api/, /api) } } }target指向 Mock 服务监听地址changeOrigin为 true 时代理转发请求会把 Host 头改成目标地址避免后端识别 Host 出错rewrite在这里保留/api前缀因为 Mock 规则里配置的路径就是/api开头。如果规则里配置的是/mock/api则 rewrite 应改为path.replace(/^\/api/, /mock/api)。这样配置后前端代码里的请求路径不需要改一行/api/user/info发出的请求会被开发服务器自动转发到 Mock 服务。注意代理只在开发服务器这一层生效生产构建不受影响。另一个容易被忽略的点代理配置只应该在开发环境生效。常见误用是把vite.config.js里的 proxy 配置直接带入生产构建导致线上接口也指向127.0.0.1。建议用环境变量区分开发与构建阶段生产分支不要加载 proxy 配置。5.2 用 hosts 指定端口模拟真实域名环境部分场景下前端代码会把接口地址写死成https://api.shop.example.com此时可以改本地 hosts 文件做域名映射127.0.0.1 api.shop.example.comMock 服务监听地址保持127.0.0.1端口 18080请求地址写成http://api.shop.example.com:18080/api/user/info时DNS 解析落到本机请求进入 Mock 服务。这种方式适合验证 CORS 跨域、Cookie 作用域与生产域名强绑定的项目。需要补充的是联调时模拟慢接口同样重要。软件支持在规则里配置 delay设置 3000ms 后前端可以观察到 loading 态、超时提示的真实表现比在代码里 sleep 更贴近生产环境。5.3 请求参数匹配与多场景响应很多 Mock 场景要求同一个接口根据参数返回不同内容。常见做法是在响应体里写${param.xxx}形式的占位符程序在请求到达时从 QueryString 或 POST Body 中提取对应值并替换。例如请求/api/order?id1001响应体里的id:${param.id}会被替换成1001一套规则就能模拟多种数据。实际业务中列表页场景最常用真实接口包含pageSize、pageNum、keyword三个参数规则里全部用占位符接收返回数据量随参数变化复用一个规则就能覆盖多个测试用例相比固定 JSON 的维护成本低很多。6. 规则库迁移与扩展把 DataServer.db 变成团队 Mock 资产最后说一个能立刻提升效率的技巧利用DataServer.db的单文件特性做规则库迁移。6.1 规则库备份与多人共用关闭软件把DataServer.db复制一份发给同事对方放入相同目录并重启软件全部接口规则就同步过去了。团队协作时可以在统一目录下维护一个 baseline 模板库新成员入职直接替换数据库文件不用在界面上逐个配置接口成本几乎为零。如果规则库越来越大可以把它提交到 Git 仓库作为团队资产但要注意提交前先确认软件已退出避免数据库内存在未落盘的缓冲数据。6.2 用 SQLite 命令批量核对规则规则量大的时候在界面上翻找效率太低可以用 SQLite 命令行工具打开数据库做批量检查sqlite3 DataServer.db .tables sqlite3 DataServer.db SELECT method, url, matchType, responseCode FROM MockRule LIMIT 50;.tables列出所有表确认规则表名SELECT 语句按需统计规则数量与匹配类型分布适合在规则库膨胀后做治理。换机器排查问题时这条命令比在界面上逐条核对快得多。6.3 扩展方向与边界依赖包里包含 MQTTnet.dll软件在 Http 之外预留了 MQTT 协议模拟的扩展空间。沿用“规则表 自动回复”的模型后续版本支持 MQTT 消息模拟是顺理成章的事。当前版本主线仍是 Http 自动回复不建议把 Mock 服务当成正式接口网关它解决的是联调阶段“接口未就绪”的问题鉴权体系和稳定性不是这类工具的设计目标。规则设计上把可复用放在优先级前列响应体统一用占位符而不是硬编码便于切换环境每个接口至少留一条错误码响应规则500、429方便前端调试异常分支把公共响应头独立维护新增规则时直接复用避免每条规则重复配置同样内容。本文还有配套的精品资源点击获取
