Files
knowledge-governance/internal/dobotaiops/fixture_env_test.go
T

102 lines
4.5 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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("放行时必须返回库名")
}
})
}
}