main函数不可直接测试，需解耦为newserver()等可导出函数，返回*http.server并注入依赖；配合testcontainers-go启动真实数据库容器、超时http客户端请求、显式清理资源，实现高可靠性端到端集成测试。
直接启动真实服务进程 + 容器化依赖 + 自动清理，是目前最可靠、可复用性最高的端到端集成测试方案。它能覆盖 main 启动逻辑、中间件、配置加载、信号处理等单元测试和 httptest.NewServer 无法触及的路径。
如何让 main 函数变成可测试的服务入口
硬编码在 func main() 里的服务启动逻辑无法被测试调用，必须解耦。核心是把监听、配置、路由初始化抽成独立函数，并返回 *http.Server 或封装后的启动器。
- 不要在
main.go里直接调用http.ListenAndServe，改用NewServer()返回已配置的*http.Server - 数据库连接、日志初始化、中间件注册等应作为参数或依赖注入，而非全局单例
- 测试中用
go server.ListenAndServe()启动，配合context.WithTimeout控制生命周期 - 务必检查
server.Addr是否为空，否则ListenAndServe可能监听:http（即 80 端口），导致权限错误或端口冲突
用 testcontainers-go 启动 PostgreSQL 等真实依赖
本地安装 PostgreSQL 或共享测试库会导致环境不一致、数据污染、CI 失败。用容器按需拉起、自动销毁，才是稳定做法。
- 使用
postgres.RunContainer（推荐）或通用testcontainers.GenericContainer，避免手写 Docker 命令或docker-compose.yml - 通过
container.ConnectionString(ctx)获取连接字符串，传给应用初始化 DB，而不是硬编码localhost:5432 - 务必在
defer中调用container.Terminate(ctx)，否则容器残留会阻塞后续测试 - 注意：PostgreSQL 容器启动有延迟，需加简单重试或
WaitForLog，否则应用可能连不上报dial tcp: connection refused
HTTP 客户端请求必须带超时，且验证完整响应链
不设超时的 http.Get 在依赖失败时会永久挂起；只校验状态码忽略 header 或 body 结构，等于没测业务逻辑。
- 永远用
http.DefaultClient.Do(req)替代http.Get，以便控制Context和Timeout - 显式设置
req.Header.Set("Accept", "application/json")，验证内容协商是否生效 - 用
json.NewDecoder(resp.Body).Decode(&v)解析响应体，断言字段值，而非只看StatusCode - 检查关键 header，比如
X-Request-ID、Content-Type，确认中间件已执行
测试结束后资源清理容易被忽略的三个点
容器、数据库连接、HTTP 服务器三者都必须显式关闭，漏掉任意一个都会导致测试套件不可重入、CI 流水线逐渐变慢甚至失败。
-
container.Terminate(ctx)必须在defer中，且放在测试函数最开头，防止 setup 阶段 panic 导致跳过 -
db.Close()要在setupTestDB()的defer里，不能只靠测试函数结尾的defer—— 若 setup 失败，该defer不会执行 -
server.Shutdown(ctx)比server.Close()更安全，能等待活跃请求完成；但要注意Shutdown本身也需超时保护，否则可能卡住
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
