测试 Go Web 中间件的核心是绕过 HTTP 服务器，直接调用中间件函数并验证其行为：检查请求 / 响应修改、next handler 调用逻辑、短路终止流程。
测试 Go Web 中间件，核心是绕过完整 HTTP 服务器启动，直接调用中间件函数并验证其行为——重点检查它是否正确修改请求 / 响应、是否按预期调用 next handler、是否在特定条件下提前终止流程。
1. 将中间件视为普通函数来测试
Go 中间件本质是接收 http.Handler 并返回新 http.Handler 的函数。测试时无需启动 net/http.Server，只需构造一个 mock handler（比如用 httptest.NewRecorder() 和 http.Request），再把中间件包装它，然后调用。
- 用
httptest.NewRequest()创建请求，支持任意方法、路径、Header、Body - 用
httptest.NewRecorder()捕获响应 状态码、Header、Body - 传入一个闭包作为 next handler，内部可记录是否被调用、传入的参数等
2. 验证中间件的“短路”逻辑
很多中间件（如鉴权、限流、CORS 预检）会在某些条件下不调用 next，直接写响应。测试这类行为的关键是：确认 next 没被执行，且 ResponseWriter 被正确写入。
- 定义一个计数器变量或布尔标志，在 next handler 内部置为 true
- 执行中间件包装后的 handler 后，断言该标志仍为 false
- 检查 recorder.Code 是否为预期值（如 401、429），recorder.Body.String() 是否含预期错误信息
3. 测试中间件对 Request/Response 的修改
例如日志中间件添加 X-Request-ID、JWT 中间件解析 token 并注入用户信息到 context、gzip 中间件压缩响应体。需验证这些副作用是否发生。
立即学习“go 语言免费学习笔记（深入）”；
- 通过
r.Context().Value(key)检查 context 是否被正确扩展（注意 key 类型要一致） - 读取 recorder.Header() 确认 Header 字段是否存在且值正确（如
rec.Header().Get("X-Request-ID") != ""） - 对 gzip 中间件，可检查
rec.Header().Get("Content-Encoding") == "gzip"，再 解压 body 验证内容
4. 使用 subtests 组织多种场景
一个中间件常需覆盖正常流程、边界输入、错误分支。用 t.Run() 分场景，让失败定位更清晰。
- 例如：
t.Run("auth header missing", func(t *testing.T) {……}) t.Run("valid jwt token", func(t *testing.T) {……})- 每个子测试独立构造 request/recorder/mock next，避免状态污染
基本上就这些。不复杂但容易忽略的是：别测“中间件是否启动了服务器”，而要测“它对单个请求做了什么”。
