package dobotaiops import ( "fmt" "net/url" "os" "strings" "testing" ) // 只读接入的集成用例会**建表/灌数据/建角色**(DROP TABLE … CASCADE),所以必须先确认 // "这是一次性隔离环境"。只凭 TEST_DATABASE_URL 存在就动手是不可接受的:一次误配置 // 就能把生产或共享库的表删掉。护栏规则(全部为硬条件): // // 1. 必须显式声明 KG_DOBOTAI_TEST_ISOLATED=1(想动库就得先表态); // 2. DSN 必须能解析、必须是 postgres DSN、必须有库名; // 3. 库名命中生产/共享库黑名单(含 "prod"、governance 等)⇒ 拒绝; // 4. 非本机主机 ⇒ 库名必须含 "test"; // 5. 本机主机 ⇒ 只额外放行规范的一次性库名 "postgres"(一次性容器默认库),其余仍须含 "test"。 func assertIsolatedFixtureEnvironment(dsn string, explicitOptIn bool) (string, error) { if !explicitOptIn { return "", fmt.Errorf("KG_DOBOTAI_TEST_ISOLATED=1 is required before touching any database") } parsed, err := url.Parse(strings.TrimSpace(dsn)) if err != nil || parsed.Scheme == "" || parsed.Hostname() == "" { return "", fmt.Errorf("TEST_DATABASE_URL must be a PostgreSQL URL") } if parsed.Scheme != "postgres" && parsed.Scheme != "postgresql" { return "", fmt.Errorf("TEST_DATABASE_URL must be a postgres URL") } database := strings.TrimPrefix(parsed.EscapedPath(), "/") if database == "" { return "", fmt.Errorf("TEST_DATABASE_URL must name a database") } lowered := strings.ToLower(database) if strings.Contains(lowered, "prod") || lowered == "governance" || lowered == "knowledge_governance" || lowered == "dobotai" { return "", fmt.Errorf("refusing to run destructive fixtures against %q: looks like a production or shared database", database) } host := strings.ToLower(parsed.Hostname()) local := host == "127.0.0.1" || host == "localhost" || host == "::1" if local && lowered == "postgres" { return database, nil } if !strings.Contains(lowered, "test") { return "", fmt.Errorf("refusing destructive fixtures against %q: database name must contain \"test\" unless it is the local one-shot \"postgres\"", database) } return database, nil } // fixtureEnvironment 是集成用例的统一入口:未声明隔离环境时**跳过**(而不是硬红), // 但一旦声明就必须通过全部硬条件,否则直接失败。 func fixtureEnvironment(t *testing.T) string { t.Helper() dsn := strings.TrimSpace(os.Getenv("TEST_DATABASE_URL")) if dsn == "" { t.Skip("TEST_DATABASE_URL is not set") } if strings.TrimSpace(os.Getenv("KG_DOBOTAI_TEST_ISOLATED")) != "1" { t.Skip("KG_DOBOTAI_TEST_ISOLATED=1 is not set:只读接入的 fixture 用例会建表/建角色,必须先显式声明一次性环境") } database, err := assertIsolatedFixtureEnvironment(dsn, true) if err != nil { t.Fatalf("隔离环境校验失败(拒绝执行任何写操作):%v", err) } return database } func TestIsolatedFixtureEnvironmentRefusesMisconfiguration(t *testing.T) { cases := []struct { name string dsn string optIn bool wantErr bool contains string }{ {"未声明隔离环境", "postgres://u:p@127.0.0.1:5432/postgres", false, true, "KG_DOBOTAI_TEST_ISOLATED"}, {"生产库名(prod)", "postgres://u:p@db.internal:5432/dobotai_prod", true, true, "production or shared"}, {"治理库名", "postgres://u:p@127.0.0.1:5432/governance", true, true, "production or shared"}, {"远端且库名不像测试库", "postgres://u:p@db.internal:5432/kgdev", true, true, "must contain"}, {"非 postgres 协议", "mysql://u:p@127.0.0.1:3306/x_test", true, true, "postgres URL"}, {"没有库名", "postgres://u:p@127.0.0.1:5432/", true, true, "must name a database"}, {"本机一次性 postgres", "postgres://u:p@127.0.0.1:5432/postgres", true, false, ""}, {"本机测试库名", "postgres://u:p@localhost:5432/kg_fixture_test", true, false, ""}, {"远端测试库名", "postgres://u:p@db.internal:5432/kg_fixture_test", true, false, ""}, } for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { database, err := assertIsolatedFixtureEnvironment(tc.dsn, tc.optIn) switch { case tc.wantErr && err == nil: t.Fatalf("必须拒绝,却放行了(database=%q)", database) case tc.wantErr && !strings.Contains(err.Error(), tc.contains): t.Fatalf("拒绝理由应包含 %q,实际:%v", tc.contains, err) case !tc.wantErr && err != nil: t.Fatalf("合法的一次性环境被拒:%v", err) case !tc.wantErr && database == "": t.Fatal("放行时必须返回库名") } }) } }