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拦截请求，而非直接 patchhttp.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 测试不会自动加载 .env 或 config.yaml。必须显式控制配置来源，否则容易出现“本地能过 CI 报错”。
立即学习“go语言免费学习笔记（深入）”；
- 测试文件中用
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() 并检查错误。
