17370845950

Go微服务测试核心是隔离性、可重复性与贴近生产：需用mockery+testify可控模拟依赖，依赖注入避免init初始化，HTTP/gRPC/DB均需动态端口与事务安全回滚。

Go 微服务的测试环境不是搭个 Docker Compose 就完事——核心在于隔离性、可重复性和贴近生产。本地跑通 go test 只是起点，真正卡住人的，是依赖服务（如 MySQL、Redis、gRPC 后端）的模拟与状态管理。

用 testify + mockery 做单元测试时如何避免真实调用外部服务

关键不是“不连”，而是“连得可控”。真实数据库或远程 gRPC 调用必须被替换为可断言、可重置的 mock 实现。

• 接口定义必须显式导出，且被依赖方按接口编程（例如 UserService 接口而非具体结构体），mockery 才能生成有效 mock
• 不要在 init() 或包级变量中初始化客户端（如 redis.Client），否则无法在测试中注入 mock；改用构造函数传参或依赖注入容器（如 dig 或手动传递）
• HTTP 客户端统一包装为接口（如 HTTPDoer），测试时用 httptest.Server 或 gock 拦截请求，而非直接 patch http.DefaultClient

type HTTPDoer interface {
	Do(*http.Request) (*http.Response, error)
}

func NewAPIClient(client HTTPDoer) *APIClient {
	return &APIClient{client: client}
}

集成测试中启动真实依赖：docker-compose up 还是 testcontainers？

本地开发阶段用 docker-compose 更快；CI 环境（如 GitHub Actions）推荐 testcontainers-go——它能确保每次测试前拉起干净实例，并在 defer 中自动清理，避免端口冲突或残留数据。

• docker-compose.yml 里所有服务必须设 restart: "no"，否则测试中途重启会导致连接中断
• MySQL 容器需挂载初始化 SQL（如 volumes: ["./test-sql/:/docker-entrypoint-initdb.d/"]），避免测试代码里执行 DDL
• 用 testcontainers.Container.GetHostEndpoint(ctx, "3306") 获取动态端口，别硬写 :3306

如何让测试环境读取独立配置而不污染开发/生产配置

Go 测试不会自动加载 .en

v 或 config.yaml。必须显式控制配置来源，否则容易出现“本地能过 CI 报错”。

• 测试文件中用 os.Setenv("ENV", "test") 触发配置加载分支，再调用你的配置初始化函数（如 LoadConfig()）
• 配置结构体字段应支持从环境变量覆盖（如 Port int `env:"PORT" default:"8080"`），用 koanf 或 viper 实现
• 禁止在 init() 里解析配置——这会让测试无法修改环境变量后再加载

gRPC 微服务测试：如何验证服务注册、健康检查和流式响应

光测 handler 函数没用，得测整个 gRPC server 生命周期：启动 → 注册 → 健康检查 → 请求路由 → 流关闭。

• 用 grpc.NewServer() 启动真实 server，监听 localhost:0（系统分配空闲端口），避免端口占用
• 健康检查必须显式注册：health.RegisterHealthServer(srv, health.NewServer())，否则 grpc_health_v1.Health.Check 会返回 UNIMPLEMENTED
• 流式测试用 client.StreamMethod(ctx) 后立即 Send()，再 Recv()，注意 io.EOF 是正常结束信号，不是错误

conn, _ := grpc.Dial("localhost:54321", grpc.WithTransportCredentials(insecure.NewCredentials()))
client := pb.NewUserServiceClient(conn)
stream, _ := client.GetUserStream(ctx)
stream.Send(&pb.GetUserStreamRequest{UserId: "u123"})
resp, _ := stream.Recv() // 不是循环，单次流式响应
if resp == nil {
    // 注意：Recv() 返回 nil 表示流已关闭，非错误
}

最常被忽略的一点：测试数据库的事务回滚不能只靠 defer tx.Rollback()——如果测试 panic，defer 不执行。务必用 testify/suite 的 SetupTest/TeardownTest，或在每个测试末尾显式 tx.Rollback() 并检查错误。