微服务自测需隔离网络/DB/第三方依赖,保留真实调用链路:HTTP测试用httptest.NewServer或NewRecorder;DB用sqlmock打桩;gRPC用bufconn内存通信;断言须防nil panic并校验error类型。

微服务环境里自测代码逻辑,不是把 go test 跑通就行——关键得绕过网络、DB、第三方 API 这些不稳定的依赖,同时保留服务真实调用链路的结构。否则测试要么假成功(mock 太松),要么一跑就挂(没拦住真实 HTTP 调用)。
HTTP handler 测试必须用 httptest.Server 或 httptest.NewRecorder
直接调用 handler 函数(如 handler(w, r))看似简单,但会跳过中间件、路由匹配、context 注入等真实流程,尤其在 go-kit 或 chi 等框架下,ctx.Value 可能为空,导致 panic 或逻辑跳过。
- 用
httptest.NewRecorder()模拟响应写入,适合单 handler 单元测试,轻量且可控 - 用
httptest.NewServer()启动真实 HTTP 服务(绑定随机端口),适合验证完整 transport 层行为,比如中间件日志、CORS、超时设置 - 注意:若 handler 内部调用了
http.DefaultClient或其他全局 client,需提前用http.Client{Transport: &http.Transport{...}}替换,否则测试会发出真实请求
数据库操作必须打桩,不能连真实 DB
集成测试连本地 PostgreSQL 或 SQLite 看似“真实”,但会导致测试变慢、状态污染、CI 环境不可控。微服务中 repo 层应与 driver 解耦,测试时用 sqlmock 或接口 mock 替代。
-
sqlmock要求你显式声明期望的 SQL 语句和返回行,比如mock.ExpectQuery("SELECT id FROM users").WillReturnRows(rows);漏掉mock.ExpectationsWereMet()会导致测试静默通过 - 别在测试里写
db.Exec("INSERT ...")—— 这等于又引入了真实依赖,mock 的意义就没了 - 如果 repo 方法返回
*sql.Rows,测试时需构造sqlmock.NewRows(...)并设好字段名,否则Scan会 panic
gRPC Server 测试优先用 bufconn 内存连接
启动真实 gRPC server 并监听端口,在 CI 或并行测试中极易端口冲突,也违背“隔离”原则。Go 官方推荐的 bufconn 是更干净的方案。
立即学习“go语言免费学习笔记(深入)”;
- 创建
bufconn.Listen和bufconn.Dialer,让 client 和 server 在内存里通信,零网络开销 - server 端用
grpc.NewServer()注册 service,client 端用grpc.Dial("bufnet", grpc.WithContextDialer(...), ...) - 注意:若 service 实现里调用了外部 gRPC client(比如调另一个微服务),这个 client 也得替换为同样基于
bufconn的 mock client,否则会穿透出去
断言必须带上下文,避免 “nil panic” 或 “假阳性”
微服务常见错误是:解析 JSON 失败后仍继续访问字段,或 DB 查询出错后还取 user.ID —— 这些在测试里不会立刻报错,但实际运行会 panic。
- 用
require.NoError做守门人,比如require.NoError(t, json.Unmarshal(body, &resp)),失败即终止,不执行后续零值访问 - JSON 响应比较用
assert.JSONEq,别用assert.Equal字符串比对;动态字段(如时间戳)先用strings.ReplaceAll抹掉再断言 - 自定义 error 类型检查必须用
assert.ErrorAs(t, err, &target),其中target是非 nil 指针,比如new(*UserNotFoundErr)
真正难的不是写测试,而是把依赖边界划清楚:每个函数/方法是否只做一件事?它的输入是否可完全控制?输出是否只依赖输入和明确传入的 interface?这些决定了你的测试能不能写得轻、快、稳。


















