全局变量和init()函数是Go单元测试中最常见的耦合源，因其隐式依赖、不可控状态和跨测试污染问题，必须通过依赖注入将环境变量、配置、客户端等转为显式参数，并用sync.Once或构造函数替代init()实现可测的懒加载。
全局变量（尤其是包级变量）和 init() 函数是 Go 单元测试里最常被忽略的耦合源——它们让测试无法控制状态、无法替换行为、甚至导致测试间相互污染。解耦不是“加个 mock 框架”，而是把隐式依赖变成显式参数。
为什么 os.Getenv 和包级 var 会让测试失效
直接在函数里调用 os.Getenv("DB_URL") 或读取包级 var config Config，等于把环境和初始化逻辑硬编码进业务路径。测试时你无法：
- 模拟不同配置场景（比如空值、非法格式、超时设置）
- 保证并发安全（多个测试同时改写同一
var） - 避免跨测试残留状态（前一个测试 setenv 后没 cleanup，后一个测试读到脏数据）
更麻烦的是，这类代码往往藏在工具函数里，比如 GetLogger() 或 NewHTTPClient()，表面无害，实则切断了所有测试入口。
把全局依赖转成构造函数参数或函数参数
核心原则：任何外部可观测状态（环境变量、配置、客户端、logger），都必须作为输入显式传入，而不是在函数体内偷偷访问。
立即学习“go语言免费学习笔记（深入）”；
例如，一个依赖环境变量初始化 DB 的服务：
// ❌ 错误：隐藏依赖
func NewUserService() *UserService {
db, _ := sql.Open("postgres", os.Getenv("DB_URL"))
return &UserService{db: db}
}应改为：
// ✅ 正确：依赖显性化
type UserService struct {
db *sql.DB
}
<p>func NewUserService(db <em>sql.DB) </em>UserService {
return &UserService{db: db}
}</p><p>// 测试时直接传入 sqlmock 或内存 DB 实例
func TestCreateUser(t *testing.T) {
mockDB, _ := sqlmock.New()
defer mockDB.Close()
svc := NewUserService(mockDB)
// ...
}对环境变量类配置，推荐封装为结构体并由调用方传入：
type Config struct {
DBURL string
TimeoutSec int
}
<p>func NewUserService(cfg Config) <em>UserService {
db, _ := sql.Open("postgres", cfg.DBURL)
db.SetConnMaxLifetime(time.Second </em> time.Duration(cfg.TimeoutSec))
return &UserService{db: db}
}替换 init() 和包级变量的三种安全方式
init() 是测试隔离的天敌——它在包导入时自动执行，无法跳过、无法重置、无法 mock。必须移除或重构。
- 把
init()里的初始化逻辑抽成普通函数，比如InitLogger()，并在main()或启动流程中显式调用 - 用
sync.Once+ 包级指针变量实现“懒加载单例”，但构造函数仍接收依赖：var logger *zap.Logger; func SetLogger(l *zap.Logger) { logger = l } - 彻底放弃包级变量，让每个需要 logger 的结构体在构造时接收
logger *zap.Logger—— 这是最干净、最易测的方式
特别注意：测试文件（_test.go）里也别用 os.Setenv() 后不恢复。优先用 testify/assert 的 assert.NoError(t, os.Unsetenv("X")) 做 cleanup，或直接绕过环境变量，走参数注入路径。
如何安全地处理第三方库的全局状态（如 log.Fatal、http.DefaultClient）
很多标准库和第三方库暴露了全局实例（log.Default()、http.DefaultClient、rand.Seed()），它们破坏可测性不是因为“难 mock”，而是因为“不该被直接用”。
- 永远不要在业务逻辑里直接调用
log.Fatal()或os.Exit()；统一返回error，由上层决定是否终止 - 把
http.Client作为字段或参数传入，而不是硬编码用http.DefaultClient；测试时传入&http.Client{Transport: &http.Transport{RoundTrip: mockRT}} - 对
rand等随机数生成器，定义接口type RandGenerator interface { Intn(n int) int }，注入rand.Rand实例而非依赖全局rand.Intn()
真正难测的从来不是逻辑本身，而是那些你以为“只是读个配置”的一行代码——它悄悄锁死了你的测试自由度。重构时盯住每一处包级变量、每一个 init()、每一次未声明的全局调用，把它们一个个拎出来，变成参数。
