必须用 echo.New().Router().ServeHTTP() 模拟请求流或直接调用中间件函数并传入伪造的 next handler，避免手写 struct 实现 echo.Context 接口导致 panic；每个测试应创建独立 echo.New() 实例以防状态污染。
怎么 mock echo.Context 测试中间件逻辑
不能直接 new 一个 echo.Context，它是个接口，必须用 echo.New().AcquireContext() 或更稳妥的 echo.New().Router().ServeHTTP() 模拟请求流。真实测试中推荐用后者——绕过 Context 构造细节，专注行为验证。
常见错误是手写 struct 实现 echo.Context 接口，漏掉方法（比如 Request()、Response()、Set()）或返回 nil 导致 panic。别硬造，用框架自带的测试辅助方式。
- 用
httptest.NewRequest()和httptest.NewRecorder()构造请求/响应对 - 调用
e.ServeHTTP(recorder, req)触发完整中间件链和路由匹配 - 检查
recorder.Code状态码、recorder.Body.String()响应内容 - 若需验证中间件是否设置了某个值（如
c.Set("user", u)），得在 handler 里显式读取并透出到响应中，否则无法断言
如何隔离测试单个中间件而不启动整个路由
中间件本质是 echo.HandlerFunc → echo.HandlerFunc 的转换函数，可直接调用，无需 Echo 实例。关键在于构造一个“假的” next handler，在里面捕获被中间件修改的行为。
例如 auth 中间件会调用 next(c) 前校验 token；你只需让 next 返回一个固定响应，并检查中间件是否提前中断（返回 error）或是否调用了 c.Set() 等副作用。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 定义
next := func(c echo.Context) error { c.Set("tested", true); return nil } - 包装：
handler := authMiddleware(next) - 用
echo.New().AcquireContext()获取 context，手动设置c.Request()Header - 执行
handler(c)，再检查c.IsSet("tested")或返回 error 类型 - 注意：
AcquireContext()返回的 context 需要Release()，否则有内存泄漏风险
测试带依赖的中间件（如依赖 DB 或配置）
中间件里如果直接 new DB 实例或读全局 config，会导致测试难 mock、慢、不稳定。必须把依赖抽成参数传入，或通过 c.Get() 从 context 取。
典型反模式：func loggingMiddleware() echo.MiddlewareFunc { return func(next echo.Handler) echo.Handler { ... db.Log(...) ... } } —— db 被硬编码，无法替换。
- 正确做法：把依赖作为闭包变量传入，如
func loggingMiddleware(logger *zap.Logger) echo.MiddlewareFunc - 测试时传入
zap.NewNop()或自定义 mock logger - 若依赖从 context 取（如
c.Get("db").(*sql.DB)），测试前用c.Set("db", mockDB) - 避免在中间件初始化阶段做耗时操作（如连接池建立），放到 handler 执行时按需获取
为什么 TestMain 或全局 setup 容易导致测试污染
多个测试共用同一个 echo.Echo 实例，或在 TestMain 里调用 e.Use() 注册中间件，会导致测试间状态泄漏。比如一个测试里 c.Set("authed", true)，下一个测试可能误读该值。
根本原因是 echo.Echo 是有状态的：它持有中间件链、路由器、配置等。并发运行测试时更危险（Go 测试默认并发执行）。
- 每个测试函数内创建独立
echo.New()实例 - 不要在
init()或TestMain()里注册中间件或路由 - 避免复用
http.Client或全局 logger 实例，除非明确是 thread-safe 的 - 如果必须共享 setup（如启动 mock server），确保 teardown 清理所有 side effect（如重置计数器、关闭 listener）
