gomock可为Kratos中interface依赖生成Mock，需指定含接口定义的Go文件，Mock实例应在测试函数内手动注入以避免DI覆盖，HTTP下游依赖则用httptest.Server模拟。
用gomock生成依赖接口的Mock实现
Kratos项目里，真实依赖服务（比如UserClient或OrderService）通常定义为interface，这是gomock能生效的前提。如果直接mock结构体或具体类型，mockgen会失败或生成无效代码。
关键动作是：从api/或internal/service/下找到对应接口定义文件（如user_service.go），再执行：
mockgen -source=user_service.go -destination=mocks/mock_user_service.go -package=mocks
注意三点：
-
-source必须指向含type XXX interface定义的Go文件，不能是.proto或实现文件 - 生成的
mock_*.go建议放在mocks/目录，避免被go build误编译进生产包 - Kratos常用
protoc-gen-go-grpc生成客户端，但gomock不处理gRPC stub，只mock你自定义的interface层
在Kratos测试中注入Mock实例而非真实Client
Kratos依赖注入靠di.NewInjector或kratos/pkg/conf/paladin加载配置，但测试时不能走完整启动流程——否则Mock会被真实Client覆盖。正确做法是在测试函数内手动构造依赖树。
典型写法：
ctrl := gomock.NewController(t)
defer ctrl.Finish()
mockSvc := mocks.NewMockUserService(ctrl)
// 替换原本通过di注入的UserService
svc := &service.OrderService{
userRepo: mockSvc, // 直接赋值，绕过DI容器
}
常见错误：
- 在
TestMain里初始化全局DI容器，导致Mock被后续app.Run()覆盖 - Mock对象没调用
EXPECT()就直接跑测试，报Unexpected call to ... - 忘记
defer ctrl.Finish()，导致未验证的Expectation静默通过，掩盖逻辑缺陷
模拟HTTP下游依赖：用httptest.Server + 自定义handler
当被测服务调用的是外部HTTP API（如支付回调、短信网关），且需要验证超时、503、响应延迟等真实网络行为时，gomock不够用——它只能控制返回值，无法模拟TCP层异常。
这时应启动一个轻量httptest.Server，并在handler里加控制逻辑：
srv := httptest.NewUnstartedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if rand.Intn(10) < 2 { // 20%概率返回503
w.WriteHeader(503)
return
}
if r.URL.Path == "/v1/user" && r.Method == "GET" {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(map[string]interface{}{"id": 123, "name": "mock-user"})
}
}))
srv.Start()
defer srv.Close()
注意：
-
NewUnstartedServer比NewServer更可控，可提前设置srv.Config.ReadTimeout模拟慢响应 - 别用
localhost:0硬编码端口，让srv.URL动态提供地址，避免端口冲突 - Kratos的
http.Client默认启用了KeepAlive，Mock server也要支持长连接，否则测试中出现connection reset
Mock数据与真实接口同步：避免proto定义漂移
Kratos项目里，.proto是接口事实来源。一旦上游服务更新了HelloReply字段，而你的Mock还返回旧结构，测试会通过但线上必错。
解决办法不是人工维护Mock数据，而是把Mock响应也从proto生成：
- 用
protoc-gen-go生成Go结构体后，在测试中用jsonpb或protojson反序列化预置的JSON样例（存为testdata/user_ok.json） - 对关键错误场景（如鉴权失败），在
api/errors.proto里定义ErrorReason枚举，Mock时统一用errors.FromGRPC(err)转成HTTP错误，保证状态码和body格式一致 - CI阶段加检查：运行
protoc --go_out=. *.proto后，用git diff --quiet确认没有未提交的生成文件，阻断proto漂移
最易忽略的一点：Kratos的transport/http中间件（如transport.HTTPError）会自动包装错误，Mock时若直接返回status.Errorf(codes.NotFound, "...")，可能被重复包装成嵌套JSON，导致前端解析失败。要确保Mock error路径和真实服务经过的error handler链路完全一致。
