用Golang标准库net/http实现轻量HTTP接口模拟器,支持按路径、方法、参数返回预设JSON数据与状态码;通过结构体封装响应配置,自动设置Content-Type并用json.NewEncoder流式编码;支持多方法校验、动态路径及热加载。

用 Golang 实现一个轻量 HTTP 接口模拟器,核心是启动一个本地 HTTP 服务,根据请求路径、方法或参数返回预设的 JSON 数据和状态码。不需要依赖外部框架,标准库 net/http 就足够。
定义路由与响应规则
通过 http.HandleFunc 或 http.ServeMux 注册路径,对不同 endpoint 返回不同数据和状态码。建议用结构体封装响应配置,便于维护:
- 每个路由对应一个响应模板:包含
StatusCode(如 200、404、500)、Body(JSON 字符串或 map 转换结果)、Headers(可选) - 支持动态路径参数(如
/users/123)可用正则或第三方路由器(如gorilla/mux),但简单场景用字符串前缀判断即可 - 示例:访问
/api/status返回200 OK和{"status":"ok"};访问/api/error返回500 Internal Server Error和错误详情
快速返回 JSON 响应
避免手动拼接 JSON 字符串,用 json.Marshal 序列化 Go 结构体或 map,并设置正确的 Content-Type 头:
- 在 handler 中调用
w.Header().Set("Content-Type", "application/json; charset=utf-8") - 用
json.NewEncoder(w).Encode(v)替代json.Marshal+w.Write,自动处理错误和流式写入 - 若需返回纯文本或空响应,可跳过 JSON 编码,直接
w.WriteHeader(statusCode)后写入字符串
支持多种 HTTP 方法和请求校验
模拟真实接口行为,需区分 GET、POST 等方法,并可校验请求头、查询参数或 JSON body:
立即学习“go语言免费学习笔记(深入)”;
- 用
r.Method判断请求类型,例如只允许POST /login,其他方法返回405 Method Not Allowed - 读取 query 参数:
r.URL.Query().Get("id");解析 JSON body:json.NewDecoder(r.Body).Decode(&req) - 可添加简单鉴权,如检查
r.Header.Get("X-API-Key") == "mock-key",不匹配则返回401
启动服务并热加载(可选进阶)
基础版用 http.ListenAndServe(":8080", nil) 即可。如需修改响应规则后不重启服务,可将配置存为 JSON 文件,用 fsnotify 监听变更并重载路由:
- 每次 reload 时清空旧 mux,新建
http.ServeMux并重新注册 handler - 生产环境不推荐热加载,但开发调试阶段非常实用
- 加个
/health或/config端点,方便查看当前模拟规则










