gorm.Open返回的是连接池管理器而非真实连接，真实连接在首次db.First等操作时按需从*sql.DB池中获取；必须调db.DB().Ping()验证连通性，并立即配置SetMaxOpenConns等参数。
gorm.Open 返回的不是连接，而是连接池管理器
很多人以为 gorm.Open 一执行就建立了真实数据库连接，其实它只初始化了一个 *gorm.DB 实例，底层包装的是 *sql.DB——后者才是 Go 标准库中真正的连接池管理器。真实连接是在第一次执行查询（如 db.First、db.Find）时才按需从池中获取或新建的。
这意味着：不调用实际操作，光靠 gorm.Open 成功返回，无法验证数据库是否真正可达；必须显式调用 db.DB().Ping() 才能触发底层连接测试。
常见错误现象：
- 服务启动时
gorm.Open没报错，但首次请求查库超时或 panic - 误以为“连上了”，结果因 DNS 解析失败、防火墙拦截、权限错误等导致首查失败
每个数据源必须独立调用 gorm.Open 并配置连接池参数
gorm.DB 是不可变封装，底层 *sql.DB 一旦创建就绑定固定 DSN。试图在运行时修改已初始化的 gorm.DB 的 DSN 或驱动参数，完全无效，甚至引发 panic。
正确做法是为每个数据源单独初始化：
- 用不同变量名区分，比如
userDB、logDB、cacheDB - 各自调用
gorm.Open，传入对应驱动和 DSN（例如mysql.Open(dsn)或postgres.Open(dsn)） - 立刻通过
db.DB()获取*sql.DB，再设置连接池参数
示例关键配置：
userDB, err := gorm.Open(mysql.Open(userDSN), &gorm.Config{})
if err != nil {
return err
}
sqlDB, err := userDB.DB()
if err != nil {
return err
}
sqlDB.SetMaxOpenConns(20)
sqlDB.SetMaxIdleConns(10)
sqlDB.SetConnMaxLifetime(7 * time.Hour)
sqlDB.SetConnMaxIdleTime(30 * time.Minute)
注意：这些参数必须对每个 *gorm.DB 单独设置，不能共用默认值——否则某分析型库占满连接，API 库就会全卡住。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
多数据源路由必须由业务层控制，GORM 不提供自动分库分表
GORM 官方不支持原生跨库分片或动态路由。所谓 db.Table("xxx") 只是动态指定表名，仍在同一个 *gorm.DB 连接池内操作单库中的不同表。
真正跨库（比如 user_001 在 shard_a，user_002 在 shard_b），你得自己根据分片键选择实例：
- 预初始化多个
*gorm.DB实例（如shardDBs[0]、shardDBs[1]） - 路由逻辑写在 handler 或 service 层，例如
shardDBs[userID%4].First(&u, userID) - 别把多个
*gorm.DB存进同一个全局变量，容易混淆；建议用结构体字段或 map 区分，比如type DBs struct { Primary *gorm.DB; Log *gorm.DB }
事务只作用于调用它的那个 *gorm.DB 实例：userDB.Transaction() 里调 logDB.Create() 完全游离在事务外——这不是 bug，是设计使然。
PostgreSQL 和 MySQL 的 DSN 配置差异容易被忽略
驱动注册和 DSN 格式不匹配，不会立刻报错，而是在首次查询时 hang 住或返回模糊错误（如 "invalid connection" 或直接 timeout）。
必须确认：
- 已导入对应驱动：
import _ "gorm.io/driver/mysql"或import _ "gorm.io/driver/postgres"（下划线不能漏） - MySQL DSN 至少含
?charset=utf8mb4&parseTime=True&loc=Local，否则某些版本握手阶段就 hang - PostgreSQL DSN 至少含
?sslmode=disable，否则可能卡在 TLS 握手 - PostgreSQL 用户名/密码含
@、/等特殊字符时，必须用url.QueryEscape()编码，否则解析失败且错误提示毫无指向性（常报"pq: password authentication failed"却密码正确）
连接池参数设得太激进也危险：比如 SetMaxIdleConns 设太大，可能被数据库拒绝（MySQL 默认 max_connections=151）；设太小又导致频繁建连销毁，增加延迟。
