本地集成测试跑不起来需先隔离数据库和外部服务：用testcontainers-go启临时postgresql容器或sqlite内存库，禁用硬编码连接、init初始化及os.setenv，改用结构体传参注入配置。
本地集成测试怎么跑不起来？先确认数据库和外部服务是否隔离
Go 项目做本地集成测试时，最常卡在连接真实数据库或调用线上 API。测试本该快速、可重复、无副作用，但一跑 go test 就报 dial tcp 127.0.0.1:5432: connect: connection refused 或超时，说明没做环境隔离。
正确做法是：测试启动前自动拉起轻量级替代服务（如 testcontainers-go 启 PostgreSQL 容器），或彻底绕过外部依赖——后者更可控、启动更快。
- 用 Docker Compose 启依赖服务时，确保
docker-compose.test.yml中 service 的ports映射明确，且 Go 测试代码读取的是该配置的地址（如localhost:5433） - 若用内存数据库（如
github.com/mattn/go-sqlite3），注意 SQLite 不支持某些 PostgreSQL 特性（如 JSONB、并发写锁行为），仅适合逻辑层验证 - 避免在
init()或包级变量中硬编码连接字符串；改用函数参数或接口注入，方便测试替换
Mock 桩怎么只在测试时生效？用 build tag 控制条件编译
想让某段 Mock 逻辑只在 go test 时编译进去，又不想污染主流程，//go:build test 是最干净的方式。它比运行时 if 判断更彻底——代码根本不会进生产二进制。
示例：定义一个 HTTP 客户端桩，仅用于测试：
package api
//go:build test
// +build test
package api
import "net/http"
func NewHTTPClient() *http.Client {
return &http.Client{
Transport: &mockRoundTripper{},
}
}
关键点：
- 文件顶部必须同时有
//go:build test和// +build test（后者兼容老版本 go toolchain） - 这个文件不能和主逻辑同名同包混在普通目录里；建议放在
api/mocks/下，且文件名含_test.go或显式加 build tag - 如果用了 Go Modules，确保
go test命令未加-tags以外的限制；默认go test会识别testtag
接口抽象不够？Mock 失效的根本原因往往是依赖没解耦
写了 Mock 文件，但测试里还是调用真实第三方 SDK，问题大概率出在依赖没通过接口注入。比如直接 new 了 aws.S3 客户端，而不是接收一个 S3API 接口。
Go 的接口即契约，Mock 的前提是“能被替换”。常见修复路径：
- 把外部依赖包装成接口：例如将
*redis.Client封装为RedisStore接口，含Get(key string) (string, error)等方法 - 构造函数接受接口而非具体类型：
NewService(redis RedisStore, http HTTPDoer)，测试时传入 mock 实现 - 避免在方法内部 new 依赖：像
func (s *Svc) Do() { client := &http.Client{} }这种写法无法 Mock，必须外置
测试环境变量怎么安全传入？别用 os.Setenv，改用结构体配置
有人习惯在 TestMain 里 os.Setenv("DB_URL", "sqlite://...")，但这会污染全局状态，多个测试并行跑可能冲突，且难追踪来源。
更稳妥的方式是把配置封装进结构体，测试时显式传参：
type Config struct {
DBURL string
APIBase string
}
func TestSomething(t *testing.T) {
cfg := Config{
DBURL: "sqlite://file:test.db?mode=memory&_fk=1",
APIBase: "http://localhost:8080",
}
svc := NewService(cfg)
// ...
}
这样既清晰又可复用，还能配合 testify/assert 验证配置是否被正确使用。
真正麻烦的是跨 package 共享配置——比如 DAO 层需要 DB URL，而 Service 层需要它初始化 DAO。这时不要靠全局变量或 init 函数，而是让上层（如 main 或 test）统一构建依赖树，再逐层注入。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
