如何让实例对象在Go测试框架的所有测试函数中可用？

在Go测试框架中，你可以通过包级变量 + TestMain的组合实现只初始化一次TestRunner并在所有测试函数中复用的需求，具体步骤如下：

1. 定义包级TestRunner变量 #

在测试包内（与tests.go同包）声明一个包级变量，用于存储初始化后的TestRunner实例：

// tests.go 或同包其他文件
package yourtestpackage

import "testing"

var testRunner *TestRunner // 包级变量，供所有测试函数访问

2. 在TestMain中完成一次性初始化 #

利用TestMain函数（整个测试包仅执行一次）读取环境变量、创建TestRunner实例并赋值给包级变量，随后启动所有测试：

// main.go
package yourtestpackage

import (
	"os"
	"testing"
)

func TestMain(m *testing.M) {
	// 读取目标域名环境变量
	targetDomain := os.Getenv("TARGET_DOMAIN")
	if targetDomain == "" {
		panic("未设置TARGET_DOMAIN环境变量")
	}

	// 初始化TestRunner实例
	testRunner = NewTestRunner(targetDomain) // 假设你有对应的构造函数

	// 执行所有测试并返回退出码
	os.Exit(m.Run())
}

3. 在测试函数中直接复用实例 #

所有TestXxx函数可以直接使用包级的testRunner，无需额外传参：

// tests.go
package yourtestpackage

import "testing"

func TestGetUser(t *testing.T) {
	resp, err := testRunner.MakeGetRequest("/users/1")
	if err != nil {
		t.Fatalf("请求失败: %v", err)
	}

	testRunner.ValidateJSONStructure(resp, expectedUserJSON)
}

func TestCreateOrder(t *testing.T) {
	resp, err := testRunner.MakePostRequest("/orders", orderPayload)
	if err != nil {
		t.Fatalf("创建订单失败: %v", err)
	}

	testRunner.AssertResponseStatus(resp, 201)
}

注意事项 #

• 若TestRunner包含可变状态（如请求计数器、缓存），需注意t.Parallel()带来的并发安全问题，必要时添加锁或设计为无状态结构。
• 若需针对不同场景使用不同实例，可结合子测试（t.Run）创建实例，但此方式会重新初始化，不符合"仅解析一次"的需求。

内容的提问来源于stack exchange，提问作者Raeglyn