golang中全局变量初始化db、配置、缓存是90%测试失败和线上panic的根源；可靠方案是从启动入口传参替代包级var，如newrouter(db gorm.db, cache redis.client)，彻底切断全局状态传播路径。
直接说结论：Golang 框架里用全局变量初始化 DB、配置、缓存，90% 的测试失败和线上 panic 都源于此。真正可靠的方案不是“加锁保护”，而是从初始化入口开始切断全局状态传播路径。
启动时传参替代包级 var
常见错误是写 var db *gorm.DB 然后在 init() 里赋值，或在 handler 中直接调用 GetDB()。这会导致测试无法替换依赖、并发下状态混乱、热重载不可行。
- 正确做法：把
*gorm.DB、*redis.Client等作为参数传给路由注册函数，例如NewRouter(db *gorm.DB, cache *redis.Client) - handler 函数签名应接收 service 实例，如
func(c *gin.Context, userSvc *UserService)，而非自己 new 或从全局取 - 避免
:=遮蔽——写db, err := sql.Open(...)会新建局部变量，真正的包级db还是 nil；必须用db, err = sql.Open(...)
测试中彻底隔离全局状态
Go 测试默认并发执行，t.Parallel() 下改一个 var Config *Config，下一个测试就可能读到脏数据——这不是偶发，是必然发生的数据竞争。
- 别依赖
TestMain做全局 reset：它只在所有测试前后各跑一次，无法覆盖并发测试间的干扰 - 每个测试开头手动备份并 defer 恢复，例如
orig := globalCache; defer func() { globalCache = orig }() - 更推荐：把原本的全局变量封装成结构体字段，测试中构造新实例，如
svc := &UserService{DB: testDB, Cache: make(map[string]int)} - 对标准库全局句柄（如
http.DefaultClient、log.SetOutput）必须在测试前用t.Setenv()或显式替换，并在 defer 中还原
配置与连接池初始化必须校验非空
*sql.DB 和 *redis.Client 是连接池句柄，设计上就是长期复用的，但初始化失败时若没显式检查，后续任何调用都会 panic。
- 启动时加载配置后，立刻校验必填项：
if viper.GetString("db.dsn") == "" { log.Fatal("missing db.dsn") } - 初始化
*gorm.DB后必须调用db.Exec("SELECT 1")或db.Stat()确认连通性，不能只看 error - 避免在
init()中做耗时操作（如连 DB、读文件），它无法返回 error，失败只能 panic，且无法被测试控制 - 第三方 SDK 的全局 client（如 AWS SDK 的
session.Must）同样要提取为可注入字段，而非包级单例
真正难的不是写个 sync.Mutex 锁住全局变量，而是让框架代码根本不需要它——所有状态都通过构造函数流入，所有外部依赖都可被替换，所有测试都能干净启动和退出。这点一旦松动，后续加再多锁、再多日志，也只是在掩盖设计缺陷。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
