// Package pgtest 给真实 PostgreSQL 集成用例提供"一个用例一个 schema"的隔离入口。 // // 为什么要单独成包:postgres 与 cmd/worker 的集成用例都要连真库,隔离逻辑只该有一份; // 复制一份到另一个包里,迟早只改一边(AGENTS.md 硬约束 1:同一含义的代码只准有一份)。 package pgtest import ( "context" "crypto/sha256" "encoding/hex" "net/url" "os" "strings" "testing" "github.com/jackc/pgx/v5/pgxpool" ) // IsolatedDatabaseURL 为当前用例建一个独立 schema 并返回指向它的连接串; // 用例结束自动 DROP。基地址为空时返回空串(调用方据此 Skip)。 func IsolatedDatabaseURL(t *testing.T, databaseURL string) string { t.Helper() if databaseURL == "" { return "" } parsed, err := url.Parse(databaseURL) if err != nil || parsed.Scheme == "" || parsed.Host == "" { t.Fatalf("TEST_DATABASE_URL must be a PostgreSQL URL: %v", err) } // 护栏:这些用例会在目标库里建/删 schema。指到业务库上就会在业务库里反复 // 建表删表(哪怕只删自己的 schema,也是在业务库上动 DDL)。所以库名必须明确 // 是一次性的(含 test),否则要求显式声明,绝不"顺便"跑在业务库上。 if databaseName := strings.TrimPrefix(parsed.Path, "/"); !strings.Contains(strings.ToLower(databaseName), "test") && os.Getenv("KG_ALLOW_NON_TEST_DATABASE_URL") != "1" { t.Fatalf("TEST_DATABASE_URL 指向的库 %q 看起来不是一次性测试库:拒绝在其中建/删 schema"+ "(确属一次性库请设 KG_ALLOW_NON_TEST_DATABASE_URL=1)", databaseName) } digest := sha256.Sum256([]byte(t.Name())) schema := "kgtest_" + hex.EncodeToString(digest[:8]) ctx := context.Background() admin, err := pgxpool.New(ctx, databaseURL) if err != nil { t.Fatalf("connect integration database: %v", err) } defer admin.Close() // 上一次被 kill 的运行可能留下同名 schema(cleanup 没跑到):先清掉自己的, // 否则紧接着的 CREATE 会撞名,整包用例连"跑起来"都做不到。只清本用例自己的名字。 if _, err := admin.Exec(ctx, "DROP SCHEMA IF EXISTS "+schema+" CASCADE"); err != nil { t.Fatalf("drop stale isolated schema: %v", err) } if _, err := admin.Exec(ctx, "CREATE SCHEMA "+schema); err != nil { t.Fatalf("create isolated integration schema: %v", err) } t.Cleanup(func() { cleanup, err := pgxpool.New(context.Background(), databaseURL) if err == nil { _, _ = cleanup.Exec(context.Background(), "DROP SCHEMA IF EXISTS "+schema+" CASCADE") cleanup.Close() } }) query := parsed.Query() query.Set("search_path", schema) parsed.RawQuery = query.Encode() return parsed.String() }