Go端到端测试需真实启动服务并验证用户可见行为；用TestMain管理生命周期，绑定localhost:0动态分配端口，轮询HTTP就绪状态，避免硬编码端口和盲目sleep。
Go 的端到端测试不是靠 go test 直接跑通 HTTP 请求就叫 E2E——它必须覆盖真实启动服务、触发外部依赖、验证最终用户可见行为的完整链路。
用 testmain 控制服务生命周期，避免端口冲突
直接在 TestMain 中启动 HTTP 服务并等待就绪，比在每个测试里反复启停更稳定。关键点是：绑定 localhost:0 让系统分配空闲端口，再用 http.Get 轮询直到服务响应成功。
- 不要硬编码
:8080—— 并行测试时会报address already in use - 启动后必须等待服务真正 ready（比如返回
200），不能只 sleep 几秒 - 用
os.Exit(m.Run())确保TestMain正确退出，否则测试可能卡住
func TestMain(m *testing.M) {
srv := &http.Server{Addr: "localhost:0"}
go func() {
http.HandleFunc("/api/user", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(200)
w.Write([]byte(`{"id":1,"name":"alice"}`))
})
srv.ListenAndServe()
}()
// 等待服务就绪
for i := 0; i < 30; i++ {
if _, err := http.Get("http://" + srv.Addr + "/api/user"); err == nil {
break
}
time.Sleep(100 * time.Millisecond)
}
code := m.Run()
srv.Close()
os.Exit(code)
}模拟外部依赖用 httptest.Server，而非真实第三方 API
E2E 测试里调真实第三方（如 Stripe、Slack）既慢又不可控。用 httptest.NewServer 挡住下游请求，返回预设响应，才能保证测试可重复、不因网络或对方变更失败。
- 真实 API 响应结构变动会导致测试突然失败，但问题不在你自己的代码
-
httptest.Server返回的是真实*http.Server，能被http.Client正常访问 - 把 mock server 地址注入你的服务配置（比如通过环境变量或构造参数）
func TestPaymentFlow(t *testing.T) {
mockStripe := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(200)
w.Write([]byte(`{"id":"pay_abc123","status":"succeeded"}`))
}))
defer mockStripe.Close()
// 启动你的主服务，并传入 mockStripe.URL 替代真实 stripe api 地址
app := NewApp(WithStripeAPI(mockStripe.URL))
// ... 触发支付流程，断言最终状态
}
立即学习“go语言免费学习笔记（深入）”；
数据库状态必须隔离：每次测试用新 schema 或清空表
共享数据库是 E2E 测试最常见失败源。两个测试同时操作 users 表，一个删数据，一个查数据，结果就是随机失败。
- PostgreSQL 推荐为每个测试创建独立 schema（
CREATE SCHEMA test_123），测试结束DROP SCHEMA - SQLite 可用内存数据库（
file::memory:?cache=shared），天然隔离 - MySQL/MariaDB 不支持 per-test schema 隔离，只能用
TRUNCATE TABLE清空关键表（注意外键约束顺序） - 绝对不要在测试里用
DELETE FROM users—— 如果有外键关联，会报错；TRUNCATE更安全
断言要检查“用户看到什么”，而不是“内部字段值”
E2E 的核心是验证端到端行为是否符合预期。比如用户提交表单后跳转到成功页、收到邮件、数据库记录状态变为 processed——这些才是有效断言点。
- 避免断言日志内容、中间缓存 key、未导出 struct 字段
- HTTP 响应优先检查状态码 + 关键 JSON 字段（如
result.status == "success"），而不是整个 body 字符串相等 - 如果涉及邮件发送，mock SMTP 服务（如
gomail+testify/mock），断言是否调用了Send方法及参数 -
前端渲染类测试（如 Chromedp）要等元素出现再取文本，别一上来就
node.Text()
真正的难点不在写测试，而在于让每个测试像一次真实用户操作那样干净地开始、可靠地结束——数据库、网络、时间、文件系统，所有外部边界都得可控。漏掉任意一个，E2E 就会变成“偶尔通过”的玄学测试。
