Kratos单元测试不启动server、接口自动化测试不用grpc.Dial:service层直接new+mock依赖,handler层用httptest.NewRequest+ServeHTTP,gRPC测试用bufconn避免真实连接。

Kratos 单元测试不启动 server,接口自动化测试不用 grpc.Dial —— 这两条是绝大多数人踩坑的起点。
service 层怎么测:直接 new + mock 依赖
service 层本质是纯逻辑,不涉及网络、HTTP 或 gRPC 传输。它的输入是 context.Context 和请求结构体,输出是响应或 error。测它不需要任何框架“启动”动作。
- 用
test.NewContext(context.Background(), test.WithValue(...))构造带测试值的上下文,避免中间件因ctx.Value缺失 panic - 为 dao、cache、config 等依赖定义 interface(如
UserRepo),service 初始化时接收 interface 而非具体实现 - 手写 mock 或用
gomock实现该 interface;注意error类型必须严格匹配(error≠*errors.StatusError) - 别在
TestMain里调app.Run()—— 它会拉起真实 server、middleware、日志、指标,污染测试隔离性
handler 层怎么测:httptest.NewRequest + ServeHTTP
handler 是 HTTP 请求入口,但测试它不等于启动真实 HTTP server。Kratos 的 http.Server 是 wrapper,真正干活的是你写的 func(http.ResponseWriter, *http.Request) 或 http.Handler 实例。
- 用
httptest.NewRequest("GET", "/helloworld/kratos", nil)构造请求 - 用
httptest.NewRecorder()捕获响应(status、header、body) - 直接调
yourHandler.ServeHTTP(recorder, req),跳过路由匹配、中间件链、server 启动等全部冗余环节 - 不要 import
kratos/pkg/net/http/recovery等 middleware 并手动 wrap —— 若 handler 本身依赖某中间件注入的 ctx.Value,用test.WithValue补上即可
gRPC 接口怎么自动化测试:放弃 grpc.Dial,改用 bufconn
在单元测试里起真实 gRPC server 再 dial,90% 情况下会卡在 context deadline exceeded 或端口冲突 —— 因为 server 生命周期难控制、dial 时机难对齐、TLS 配置易错。
- 用
grpc.NewClient+grpc.WithTransportCredentials(insecure.NewCredentials())+grpc.WithContextDialer(bufconn.Dialer) - server 端用
bufconn.Listen("10.0.0.1:1")创建内存 listener,再传给grpc.NewServer() - client dial 地址写成
"bufconn"(不是真实地址),由bufconn.Dialer自动桥接 - 别 mock
kratos/pkg/conf/paladin—— 改用paladin.Toml("...")加载测试配置字符串,更轻量、更可控
为什么不用 Kratos 官方 testing 包?
kratos/pkg/test 或 kratos/pkg/testing 提供了 NewApp、NewServer 等封装,看似省事,实际隐藏了依赖注入路径和初始化顺序。一旦 service 依赖某个未被自动注入的 config 字段,或 middleware 读取了未设置的 ctx.Value,测试就 panic,且堆栈难定位。
真正干净的测试,是把初始化逻辑显式写在每个 test 函数里:从 test.NewContext 开始,到 new(Service),再到 mockRepo.GetUser 返回值 —— 每一步都可 inspect、可断点、可复现。复杂点在于依赖 interface 的抽象粒度,容易被忽略的是 error 类型一致性与 ctx.Value 的显式注入时机。


















