102 lines
4.5 KiB
Go
102 lines
4.5 KiB
Go
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("放行时必须返回库名")
|
||
}
|
||
})
|
||
}
|
||
}
|