Go 的 TestMain 函数中声明的变量作用域仅限于该函数内部，无法被普通测试函数访问；需通过包级全局变量并在 TestMain 中初始化，才能安全供所有测试用例复用。
go 的 `testmain` 函数中声明的变量作用域仅限于该函数内部，无法被普通测试函数访问；需通过包级全局变量并在 `testmain` 中初始化，才能安全供所有测试用例复用。
在 Go 的测试框架中，TestMain(m *testing.M) 是测试入口的自定义钩子，常用于执行一次性初始化（如数据库连接、配置加载）和清理工作。但需特别注意：在 TestMain 函数内部使用 := 声明的变量（如 dbInstance）是局部变量，其生命周期随 TestMain 执行结束而终止，且作用域完全不对外暴露。因此，当 TestSomeFeature 尝试引用 dbInstance 时，编译器会报错 undefined——这不是运行时问题，而是编译期符号不可见。
✅ 正确做法是：将需跨测试共享的资源声明为包级（全局）变量，并在 TestMain 中完成初始化。例如：
// 声明为包级变量（注意导出首字母大写，若需跨包访问）
var DbInstance *Repo // 替换为你的实际类型，如 *sql.DB 或自定义仓库结构体
func TestMain(m *testing.M) {
dbConn := "working_db_connection"
var err error
DbInstance, err = InitializeRepo(dbConn, 2)
if err != nil {
log.Fatalf("failed to initialize test DB: %v", err)
}
// 可选：defer 清理逻辑（需确保在 m.Run() 后执行）
defer func() {
if DbInstance != nil {
// 执行关闭、清理等操作
// DbInstance.Close()
}
}()
code := m.Run()
os.Exit(code)
}
随后，任意测试函数即可直接访问该变量：
func TestSomeFeature(t *testing.T) {
if DbInstance == nil {
t.Fatal("DbInstance not initialized")
}
fmt.Printf("Using repo: %+v\n", DbInstance)
// 继续编写业务逻辑断言...
}
⚠️ 注意事项：
- 全局变量必须在
TestMain中完成初始化，避免测试并发时出现未初始化 panic； - 若资源支持并发安全（如
*sql.DB），可被多个测试共用；否则建议按需创建隔离实例（如每个测试启动独立内存数据库）； -
TestMain中务必调用m.Run()并传递返回值给os.Exit()，否则测试不会执行； - 避免在
TestMain中使用t.Log或t.Fatal（*testing.T不可用），应改用log包或标准输出； - 如需测试后清理，将
defer放在m.Run()之前（因defer按后进先出执行，确保在os.Exit()前触发）。
通过这种显式声明 + 集中初始化的模式，既能保证资源复用效率，又能维持 Go 测试的清晰作用域边界与可维护性。
