httptest.NewRecorder 是 Go 接口测试默认起点，适合验证输入校验、状态码、JSON 响应等核心逻辑；集成测试需用 testcontainers-go 启动可控真实依赖；推荐表格驱动分层断言，并注意 CI 中资源清理与超时控制。
httptest.NewRecorder 足够覆盖大多数接口逻辑验证
别一上来就起真实服务——httptest.NewRecorder 是 Go 接口测试的默认起点，它不占端口、无网络开销、执行快，适合验证 handler 的输入校验、状态码、JSON 响应结构等核心逻辑。
- 直接传
http.HandlerFunc或实现了http.Handler的结构体进去，把 handler 当纯函数测 - 发 JSON 请求时，必须手动设置
req.Header.Set("Content-Type", "application/json")，否则很多 handler 会直接返回 415 - 请求体用
json.Marshal生成，且检查 error；响应体用json.Unmarshal解析到最小结构体，避免字段新增导致测试脆性 - 别忽略 status code：错误路径（如参数缺失）必须显式调用
w.WriteHeader(http.StatusBadRequest)，否则测试里收到的是 200 + 错误 body，根本发现不了问题
集成测试要启动真实依赖，但得可控可销毁
当 handler 依赖 DB、Redis 或第三方 HTTP 服务时，httptest.NewRecorder 就不够了——你得让测试连上真实后端，但不能靠本地固定端口或全局数据库实例。
- 用
testcontainers-go启 PostgreSQL/MySQL/Redis 容器，每次测试前拉起、测试后自动清理，避免环境污染 - 连接字符串从容器动态获取（比如
container.Host() + ":" + container.MappedPort(t, "5432/tcp")），别硬编码 localhost:5432 - 在
TestMain里统一管理资源生命周期：启动容器 → 初始化 schema → 运行测试 → 关闭容器，别在每个 test 函数里重复 connect/close - 若用本地 Docker Compose，确保
docker-compose.yml中服务名与 Go 代码里写的 host 一致（如postgres而非localhost），否则 DNS 解析失败
测试用例组织推荐表格驱动 + 分层断言
接口测试不是写一堆 TestXXX 函数，而是按场景归类、用结构体描述输入输出、分层校验结果。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 每个测试 case 包含：
name（可读）、method/url、body（预 marshaled []byte）、headers、expectedStatus、expectedJSON（最小结构体） - 断言分三层：HTTP 状态码 → Content-Type 头 → 响应体字段（用
assert.Equal或原生t.Errorf） - 错误路径单独列 case：比如 token 缺失时 status=401、body 含
{"error":"unauthorized"}，别只测 “成功登录” - 并发测试加
testing.T.Parallel()，但每个 goroutine 必须用独立的http.Client和超时控制（http.DefaultClient.Timeout = 5 * time.Second）
CI 中跑集成测试容易卡在资源泄漏或超时
本地能过，CI 报 timeout 或 connection refused，大概率是容器没关干净、DB 连接池耗尽、或没设上下文 deadline。
立即学习“go语言免费学习笔记（深入）”；
- 所有
testcontainers.GenericContainer必须配defer container.Terminate(ctx)，否则容器残留，下次 run 直接端口冲突 - DB 连接对象（
*sql.DB）别复用跨测试，每个 test 函数新建并defer db.Close() - HTTP client 调用必须带 context：用
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)，防止第三方服务 hang 住整个 job - GitHub Actions 里加
timeout-minutes: 10防止无限等待，同时日志里打印容器 IP 和端口，方便 debug
真正麻烦的不是写测试，是让测试在 CI 里稳定跑通——容器启停顺序、连接池复用、context 生命周期，任何一个点漏掉，都会让“绿勾”变成随机红叉。
