如何使用Golang实现HTTP接口模拟器_返回模拟数据和状态码

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

用 Golang 实现一个轻量 HTTP 接口模拟器,核心是启动一个本地 HTTP 服务,根据请求路径、方法或参数返回预设的 JSON 数据和状态码。不需要依赖外部框架,标准库 net/http 就足够。

定义路由与响应规则

通过 http.HandleFunchttp.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 方法和请求校验

模拟真实接口行为,需区分 GETPOST 等方法,并可校验请求头、查询参数或 JSON body:

  • 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 端点,方便查看当前模拟规则