Go中Echo框架的HTTP handler单元测试应将handler抽为独立函数并用接口mock依赖，Context用echo.NewContext+httptest.NewRequest构造，避免集成测试和无效mock。
Go 里用 Echo 框架写 HTTP handler，单元测试不能靠启动服务器跑请求——那样不是单元测试，是集成测试。真正高效的测试方式是把 handler 当普通函数拆出来测，依赖项全用接口 mock。
handler 必须抽成独立函数，不能写在匿名闭包里
Echo 的 echo.HandlerFunc 类型本质是 func(echo.Context) error，但直接在 GET("/user", func(c echo.Context) error { ... }) 里写逻辑会导致：无法单独调用、无法注入 mock 依赖、无法覆盖分支路径。
正确做法是把核心逻辑提取为可导出函数：
func GetUserHandler(repo UserRepository) echo.HandlerFunc {
return func(c echo.Context) error {
id, _ := strconv.Atoi(c.Param("id"))
user, err := repo.GetUserByID(id)
if err != nil {
return c.JSON(http.StatusNotFound, map[string]string{"error": "not found"})
}
return c.JSON(http.StatusOK, user)
}
}
这样测试时就能传入 &MockUserRepository{}，而不用动路由注册逻辑。
mock 接口必须满足 Go 的编译期替换规则
Go 没有运行时方法替换，所有 mock 都依赖「接口 + 依赖注入」。常见错误包括：
-
UserRepository接口名或方法名未首字母大写（如写成userrepository或getUserByID），导致生成的 mock 类型不可见 - 被测代码里直接用了
*UserRepoImpl结构体指针，而不是UserRepository接口类型 → 根本没法替换成 mock -
mockgen命令的-source指向了实现文件（如repo_impl.go），而不是定义接口的文件（如repo.go） - 测试文件中 import 的 mock 包路径和
mockgen -package=xxx不一致，比如生成时用了-package=mocks，但测试里写了import "myapp/repo/mocks"
gomock 生成命令要带完整路径和显式包名
别信“自动推断”，mockgen 很容易因路径模糊失败。标准写法必须明确三个参数：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
-
-source：接口定义所在文件的相对路径（从模块根目录起算），例如./internal/repo/user.go -
-destination：生成文件的完整路径，例如./internal/repo/mocks/user_mock.go -
-package：生成代码所属包名，必须和 destination 所在目录一致，例如mocks（不是repo/mocks）
典型命令：
mockgen -source=./internal/repo/user.go -destination=./internal/repo/mocks/user_mock.go -package=mocks
执行前确认：go install go.uber.org/mock/mockgen@latest 已安装，且 $GOPATH/bin 在 $PATH 中。
手写 mock 比 gomock 更快，适合简单接口
如果接口只有 1–2 个方法，手写 mock 几乎零成本，还能避免 gomock 的 EXPECT/CTRL 等样板代码干扰阅读：
type MockUserRepository struct {
GetUserByIDFunc func(int) (*User, error)
}
func (m *MockUserRepository) GetUserByID(id int) (*User, error) {
if m.GetUserByIDFunc != nil {
return m.GetUserByIDFunc(id)
}
return &User{ID: id, Name: "test"}, nil
}
测试中直接控制返回值：
mockRepo := &MockUserRepository{
GetUserByIDFunc: func(id int) (*User, error) {
if id == 123 {
return &User{ID: 123, Name: "Alice"}, nil
}
return nil, errors.New("not found")
},
}
handler := GetUserHandler(mockRepo)
这种写法没有反射开销，调试时变量名清晰，也更容易加断言验证调用次数（比如用一个 callCount int 字段自增）。
最常被忽略的一点：Echo 的 echo.Context 本身也要 mock——它不是接口，但 echo.NewContext 可以配合 httptest.NewRequest 构造真实可用的上下文，不需要第三方 mock 库。别去 mock echo.Context 的方法，那是在给自己挖坑。
