echo框架不提供mock工具，应mock handler依赖的service/repo接口而非echo.context；正确做法是用httptest构造请求响应、注入mock服务并驱动真实echo实例执行。
直接结论：Echo 框架本身不提供 Mock 工具，Mock 的对象是 handler 依赖的 service / repo 接口，不是 Echo.Context 或 echo.Echo 实例。
为什么不能 Mock echo.Context
echo.Context 是一个接口，但它的实现（如 echo.context）被设计为 runtime 绑定，内部强耦合 HTTP 请求生命周期、中间件栈和上下文取消机制。强行 Mock 它会导致：
- 测试中无法真实触发中间件逻辑（如 auth、logger）
- 调用
c.Get("key")或c.Request().Context()时行为不可控，容易 panic - mockery 或 gomock 生成的 Mock 实现无法覆盖所有方法（比如
Bind内部调用json.Unmarshal和c.Request().Body）
真正该 Mock 的，是你在 handler 里显式依赖的业务接口，比如 user.Service、subject.Repo —— 这些才是你控制逻辑边界的地方。
用 httptest + Mock service 才是标准路径
对 Echo handler 做单元测试，正确姿势是：
- 用
httptest.NewRequest和httptest.NewRecorder构造请求与响应记录器 - 手动构造一个带 Mock 依赖的 handler 实例（例如
h := &handler{svc: mocks.NewUserService(t)}） - 把 handler 方法注册到
echo.Echo实例上，再用e.ServeHTTP(w, req)驱动整个 HTTP 流程
示例关键片段：
func Test_createUser(t *testing.T) {
req := httptest.NewRequest(http.MethodPost, "/users", strings.NewReader(`{"name":"a","email":"a@b.c"}`))
w := httptest.NewRecorder()
e := echo.New()
// Mock service 注入
svc := mocks.NewUserService(t)
svc.EXPECT().Create(mock.Anything, mock.Anything).Return(&model.User{ID: 1}, nil)
h := &handler{svc: svc}
e.POST("/users", h.createUser)
e.ServeHTTP(w, req)
assert.Equal(t, http.StatusCreated, w.Code)
}
注意：这里没 Mock echo.Context，而是让真实 Echo 实例创建它；Mock 的只是 handler 里调用的 svc.Create。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
mockery 生成 Mock 时必须匹配接口定义位置
mockery 不读取 AST，只按文件路径扫描 type X interface 块。如果接口定义在 internal/service/user.go，命令必须写成：
mockgen -source=internal/service/user.go -package=mocks -destination=internal/service/mocks/user_mock.go
常见错误包括：
- 路径写错（如漏掉
internal/），导致生成空文件或报错no interfaces found - 包名与测试文件 import 路径不一致，编译时报
undefined: mocks.UserService - 接口方法签名变更后未重跑
mockgen，导致 Mock 方法缺失或参数类型不匹配
建议把生成命令固化进 Makefile 的 mock target，避免手动执行遗漏。
集成测试别跳过真实 DB 初始化
Mock 单元测试能覆盖逻辑分支，但无法验证 SQL 拼写、GORM 关联加载、事务隔离级别等。一旦涉及 gorm.DB 或 redis.Client，就得切到集成测试模式：
- 启动本地 MySQL 容器（如
docker run --rm -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root mysql:8） - 测试前用
db.Migrator().DropTable(&model.User{})清库，再Migrate - 不要在测试里复用全局
db *gorm.DB实例——每个测试应获取新连接或用db.Session(&gorm.Session{NewDB: true})
否则你会遇到：前一个测试残留数据污染后一个测试、事务未回滚导致主键冲突、连接池耗尽超时等难以复现的问题。
最易被忽略的一点：Mock 接口的方法签名必须与真实实现完全一致，包括参数是否为指针、error 是否为第二个返回值、是否使用 context.Context —— 少一个 context.Context 参数，EXPECT().Call 就永远不命中。
