Beego多库配置必须用前缀区分(如dev_dbhost),AppConfig.String不支持同名key重复读取;ORM操作须调用NewOrmWithDB("alias")指定库,且RegisterDataBase需注册唯一alias,连接串必须含charset=utf8mb4、parseTime=True和loc=Local。

beego.AppConfig.String 读多库配置必须加前缀
Beego 的 app.conf 不支持同名 key 多次定义,dbhost = 127.0.0.1 写两次,后一个会覆盖前一个。想配 dev、test、prod 三个库,就得用语义化前缀隔离:
-
dev_dbhost、dev_dbport、dev_username、dev_dbname -
test_dbhost、test_dbport、test_userpwd、test_dbname -
prod_dbhost等同理
端口号是字符串类型,dev_dbport 值必须写成 "3306",不能写数字 3306;否则拼接连接串时会 panic。
RegisterDataBase 必须注册唯一 alias,且驱动注册要前置
每个库都要调用 orm.RegisterDataBase,并传入唯一 alias(如 "dev"、"test"),不能只注册 "default" 就完事。更重要的是:orm.RegisterDriver("mysql", orm.DRMySQL) 必须在任何 RegisterDataBase 之前执行,否则会报 driver: unknown driver "mysql" 错误。
连接串里漏掉关键参数会导致中文乱码或 time 解析失败:
- 必须含
?charset=utf8mb4(不是utf8),否则 MySQL 8.0+ 插入 emoji 或四字节字符报Incorrect string value - 必须含
&parseTime=True,否则time.Time字段反序列化为零值 - 必须含
&loc=Local,否则服务器 UTC 时区下时间显示比本地快 8 小时
示例拼接:
dev_db_data_source := dev_username + ":" + dev_userpwd + "@tcp(" + dev_dbhost + ":" + dev_dbport + ")/" + dev_dbname + "?charset=utf8mb4&parseTime=True&loc=Local"
ORM 操作必须显式指定 alias,NewOrm() 默认只连 default
这是最常踩的坑:orm.NewOrm() 永远只使用 "default" 这个 alias,跟你注册了多少个库完全无关。要操作 dev 库,必须写:
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
o := orm.NewOrmWithDB("dev")
后续所有操作都基于这个 o 实例,比如:
o.Read(&u, "id")o.QueryTable("user").Filter("status", 1).All(&users)-
o.Begin()启动事务(注意:仅限单库,不跨库)
别试图在同一个事务里混用多个 alias —— Beego 的 Begin()/Commit() 只绑定当前 Orm 实例所用的数据库连接,跨库事务需靠最终一致性方案补足。
分库分表场景下,alias 切换要和路由逻辑强绑定
如果按 user_id 分库,你得在 controller 或 service 层根据请求参数算出该走哪个库,再动态选 alias:
- 先解析
user_id,哈希取模得库序号(如shardId := user_id % 4) - 映射到 alias 名(如
alias := fmt.Sprintf("shard_%d", shardId)) - 再调用
orm.NewOrmWithDB(alias)
这个逻辑不能写死在 model 层,也不能依赖中间件全局切换——因为 Beego 没有类似 Spring 的 AbstractRoutingDataSource 机制,连接选择必须在业务代码中显式完成。一旦漏掉判断或映射错误,请求就会落到错误的物理库上,查不到数据或写错地方。










