Go语言应用测试架构与循环引用解决方案

myapp/
├── controllers/
│   └── account.go
├── models/
│   ├── account.go
│   └── account_test.go
├── components/
│   └── comp1/
│       ├── impl.go
│       └── impl_test.go
└── testutil/
    ├── database.go
    └── models.go

// myapp/models/account.go
package models

type Account struct {
    ID   int
    Name string
}

func GetAccountByID(id int) *Account {
    // 实际获取账户的逻辑
    return &Account{ID: id, Name: "Test Account"}
}

// myapp/models/test_utils_test.go
// 注意：这个文件仍然属于 'models' 包
package models

import (
    "testing"
    // 不需要导入 testutil 或其他外部包来访问 models 内部结构
)

// setupTestDB 是一个辅助函数，用于在 models 包的测试中设置数据库
func setupTestDB(t *testing.T) {
    t.Helper() // 标记为测试辅助函数
    // 模拟数据库连接或清空数据等操作
    t.Log("Setting up test database for models package...")
    // ... 实际的数据库设置逻辑
}

// createTestAccount 是一个辅助函数，用于创建测试账户实例
func createTestAccount(id int, name string) *Account {
    return &Account{ID: id, Name: name}
}

// myapp/models/account_test.go
package models

import (
    "testing"
    "github.com/stretchr/testify/assert"
)

func TestGetAccountByID(t *testing.T) {
    setupTestDB(t) // 调用 models 包内部的测试辅助函数

    account := createTestAccount(1, "Alice") // 调用 models 包内部的测试辅助函数
    // 假设这里将 account 插入到模拟数据库

    retrievedAccount := GetAccountByID(1)
    assert.NotNil(t, retrievedAccount)
    assert.Equal(t, account.Name, retrievedAccount.Name)
}

// myapp/components/comp1/impl.go
package comp1

import "fmt"

type Client struct {
    // ... 客户端配置
}

func NewClient(config string) *Client {
    fmt.Printf("Initializing comp1 client with config: %s\n", config)
    return &Client{}
}

func (c *Client) DoSomething() string {
    return "comp1 did something"
}

// myapp/components/comp1/impl_test.go
package comp1

import (
    "os"
    "testing"
    "github.com/stretchr/testify/assert"
)

var testClient *Client

// TestMain 是一个特殊的函数，用于在运行包内所有测试之前进行一次性设置和清理
func TestMain(m *testing.M) {
    // 在这里进行 comp1 客户端的初始化
    // 不需要导入外部 testutil 包
    testClient = NewClient("test_config_for_comp1")
    // ... 其他 setup 逻辑

    // 运行所有测试
    code := m.Run()

    // 在所有测试运行后进行清理
    // ... teardown 逻辑

    os.Exit(code)
}

func TestDoSomething(t *testing.T) {
    assert.NotNil(t, testClient, "Client should be initialized by TestMain")
    result := testClient.DoSomething()
    assert.Equal(t, "comp1 did something", result)
}

func TestAnotherFunction(t *testing.T) {
    assert.NotNil(t, testClient, "Client should be initialized by TestMain")
    // ... 使用 testClient 进行其他测试
}