package database import ( "errors" "fmt" "strings" "sync" "github.com/EthanCodeCraft/xlgo-core/config" "github.com/EthanCodeCraft/xlgo-core/logger" "gorm.io/driver/mysql" "gorm.io/driver/postgres" "gorm.io/gorm" "gorm.io/gorm/clause" "gorm.io/gorm/schema" ) // 内置驱动常量(更多驱动可通过 RegisterDialect 扩展) const ( DriverMySQL = config.DriverMySQL DriverPostgres = config.DriverPostgres ) // DialectorFactory 根据 DSN 返回 GORM Dialector type DialectorFactory func(dsn string) gorm.Dialector // DialectSpec 描述一种数据库方言:如何建立连接 + 如何拼接 DSN type DialectSpec struct { // Name 驱动主名称(如 "mysql"、"postgres"、"sqlite"),大小写不敏感 Name string // Aliases 驱动别名(如 postgres 的 "postgresql"、"pg") Aliases []string // Dialector 由 DSN 构造 GORM Dialector Dialector DialectorFactory // DSN 由 DatabaseConfig 拼接连接字符串。可选。 // 不提供时仅 CustomDSN 能直接生效;需要由配置字段拼接连接串的自定义驱动应显式提供该函数。 DSN config.DSNBuilder } var ( dialectsMu sync.RWMutex dialects = map[string]DialectorFactory{} ) // RegisterDialect 注册一种数据库方言。 // 同时把 DSN 构建器登记到 config 包,使 cfg.Database.DSN() 也能识别新驱动。 // 已注册的同名驱动会被覆盖。 // // 用法示例(接入 SQLite): // // import "gorm.io/driver/sqlite" // // database.RegisterDialect(database.DialectSpec{ // Name: "sqlite", // Dialector: func(dsn string) gorm.Dialector { return sqlite.Open(dsn) }, // DSN: func(c *config.DatabaseConfig) string { return c.Name }, // 文件路径 // }) func RegisterDialect(spec DialectSpec) { if spec.Dialector == nil || strings.TrimSpace(spec.Name) == "" { return } dialectsMu.Lock() for _, n := range append([]string{spec.Name}, spec.Aliases...) { key := normalizeDriver(n) if key != "" { dialects[key] = spec.Dialector } } dialectsMu.Unlock() if spec.DSN != nil { config.RegisterDSNBuilder(spec.Name, spec.DSN, spec.Aliases...) } } // LookupDialect 查找已注册的 Dialector 工厂 func LookupDialect(driver string) (DialectorFactory, bool) { key := normalizeDriver(driver) dialectsMu.RLock() defer dialectsMu.RUnlock() f, ok := dialects[key] return f, ok } // RegisteredDialects 返回所有已注册的驱动名(用于诊断) func RegisteredDialects() []string { dialectsMu.RLock() defer dialectsMu.RUnlock() names := make([]string, 0, len(dialects)) for k := range dialects { names = append(names, k) } return names } // Dialector 根据配置返回 GORM Dialector。 // 驱动由 cfg.Database.Driver 决定;未指定时默认 MySQL,非空但未注册时返回会初始化失败的 // Dialector,避免拼写错误静默回退到 MySQL。 func Dialector(cfg *config.Config) gorm.Dialector { if cfg == nil { logger.Warn("database: 配置为空,回退到 MySQL 空 DSN") return mysql.Open("") } return dialectorForDSN(cfg.Database.Driver, cfg.Database.DSN()) } // dialectorForDSN 根据驱动名和 DSN 返回 Dialector func dialectorForDSN(driver, dsn string) gorm.Dialector { normalized := normalizeDriver(driver) if normalized == "" { normalized = DriverMySQL } if f, ok := LookupDialect(normalized); ok { return f(dsn) } logger.Warnf("database: 驱动 %q 未注册(已注册: %s),拒绝静默回退到 MySQL;请修正配置或先注册方言", normalized, strings.Join(RegisteredDialects(), ", ")) return errorDialector{ name: "invalid", err: fmt.Errorf("数据库驱动未注册: %s", normalized), } } type errorDialector struct { name string err error } func (d errorDialector) Name() string { return d.name } func (d errorDialector) Initialize(*gorm.DB) error { if d.err == nil { return errors.New("数据库驱动未注册") } return d.err } func (d errorDialector) Migrator(*gorm.DB) gorm.Migrator { return nil } func (d errorDialector) DataTypeOf(*schema.Field) string { return "" } func (d errorDialector) DefaultValueOf(*schema.Field) clause.Expression { return nil } func (d errorDialector) BindVarTo(clause.Writer, *gorm.Statement, any) {} func (d errorDialector) QuoteTo(writer clause.Writer, str string) { _, _ = writer.WriteString(str) } func (d errorDialector) Explain(sql string, _ ...any) string { return sql } // normalizeDriver 规范化驱动名(小写、去空白) func normalizeDriver(name string) string { return strings.ToLower(strings.TrimSpace(name)) } // driverDescription 返回带别名提示的驱动描述(用于错误信息和日志) func driverDescription(driver string) string { key := normalizeDriver(driver) if key == "" { return DriverMySQL + " (default)" } if _, ok := LookupDialect(key); ok { return key } return fmt.Sprintf("%s (unregistered)", key) } func init() { // 内置 MySQL RegisterDialect(DialectSpec{ Name: DriverMySQL, Dialector: func(dsn string) gorm.Dialector { return mysql.Open(dsn) }, DSN: func(c *config.DatabaseConfig) string { return c.MySQLDSN() }, }) // 内置 PostgreSQL RegisterDialect(DialectSpec{ Name: DriverPostgres, Aliases: []string{"postgresql", "pg"}, Dialector: func(dsn string) gorm.Dialector { return postgres.Open(dsn) }, DSN: func(c *config.DatabaseConfig) string { return c.PostgresDSN() }, }) }