0

0

如何使用Golang模拟HTTP请求_Golang httptest模拟客户端请求示例

P粉602998670

P粉602998670

发布时间:2025-12-30 17:22:00

|

749人浏览过

|

来源于php中文网

原创

应使用 httptest.NewServer 启动临时 HTTP 服务器并传入 handler,获取 server.URL 发起请求,且必须 defer server.Close();需精细控制请求时用 httptest.NewRequest 构造 *http.Request,配合 httptest.NewRecorder 测试 handler 行为。

如何使用golang模拟http请求_golang httptest模拟客户端请求示例

httptest.NewServer 启动测试 HTTP 服务

别直接写 http.Get 去调真实接口——测试时应隔离外部依赖。Go 标准库httptest 包提供 NewServer,它会启动一个临时 HTTP 服务器,返回可访问的 URL(如 http://127.0.0.1:34212),你拿这个 URL 当目标发请求即可。

关键点:

  • NewServer 接收一个 http.Handler,通常传入你的业务路由(比如 http.HandlerFunchttp.ServeMux
  • 它自动监听随机空闲端口,无需手动选端口或处理 ListenAndServe 错误
  • 必须调用 server.Close() 结束,否则 goroutine 和端口会泄漏
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    if r.URL.Path == "/api/user" && r.Method == "GET" {
        w.WriteHeader(http.StatusOK)
        w.Write([]byte(`{"id":1,"name":"alice"}`))
    }
}))
defer server.Close() // 必须加

resp, err := http.Get(server.URL + "/api/user")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

httptest.NewRequest 构造请求对象

当你需要控制请求头、Body、Method、URL 查询参数等细节(比如测试登录接口带 Authorization 头),就不能只靠 http.Get。此时用 httptest.NewRequest 创建原始 *http.Request,再交给你的 handler 处理。

常见使用场景:

立即学习go语言免费学习笔记(深入)”;

Rationale
Rationale

Rationale 是一款可帮助企业主、经理和个人做出艰难的决定的AI工具

下载
  • 测试中间件(如鉴权、日志)是否正确读取 header
  • 验证 JSON 请求体是否被正确解析
  • 模拟不同 method(PUTDELETE)或 content-type
req := httptest.NewRequest("POST", "/login", strings.NewReader(`{"user":"bob","pass":"123"}`))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer abc123")

rr := httptest.NewRecorder()
handler := http.HandlerFunc(yourLoginHandler)
handler.ServeHTTP(rr, req)

if rr.Code != http.StatusOK {
    t.Errorf("expected status OK, got %d", rr.Code)
}

为什么不用 net/http/httptest 模拟客户端?

名字容易误导:httptest 的核心定位是「测试服务端逻辑」,不是模拟客户端行为。它提供的 NewRequestNewRecorder 是为服务端 handler 测试服务的;NewServer 是为客户端代码提供可控后端——但它本身不封装 http.Client 行为。

也就是说:

  • 你仍要用标准 http.Client 发请求(如 client.Do(req)
  • httptest 不替代 http.Client,只帮你解决「往哪发」和「怎么构造请求对象」的问题
  • 若需 mock 客户端行为(如强制返回错误、延迟响应),得自己包装 http.RoundTripper,或用第三方库如 gock

容易漏掉的清理和边界情况

测试中端口泄漏和 Body 未关闭是最常导致 CI 失败或本地运行变慢的问题。

  • httptest.NewServer 启动后,必须配对 defer server.Close(),哪怕测试 panic 也要生效,建议用 defer func() { server.Close() }()
  • 所有 resp.Body 必须显式 Close(),否则连接不会释放,后续请求可能卡住
  • 如果 handler 内部调用了 http.Redirect,默认不会跟随跳转,需手动检查 resp.StatusCode 是否为 302,或用带 CheckRedirect 的 client
  • httptest.NewRequest 的 body 参数如果是 strings.NewReader,记得内容要合法(比如 JSON 字符串不能少引号)

复杂点往往不在逻辑,而在这些隐式资源管理上。漏掉一次 Close(),可能让整个测试套件在并发下间歇性失败。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

173

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

224

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

335

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

206

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

193

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

187

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

桌面文件位置介绍
桌面文件位置介绍

本专题整合了桌面文件相关教程,阅读专题下面的文章了解更多内容。

0

2025.12.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.1万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号