Beego数据库配置必须通过conf/app.conf声明并显式注册驱动和数据源,且ORM初始化须在beego.Run()前完成;配置需在对应runmode节(如[dev])下用mysql/postgres/sqlite3等固定key写完整DSN,再调用orm.RegisterDriver、RegisterDataBase和RunSyncDB三步注册。

Beego 的数据库配置不是靠写 SQL 连接字符串完事,而是必须通过 conf/app.conf 文件声明连接参数,并在代码中显式调用 orm.RegisterDriver 和 orm.RegisterDataBase 才能生效。
app.conf 里怎么写数据库配置项
Beego 不读取环境变量或命令行参数来初始化数据库,只认 conf/app.conf 中的 [dev]、[prod] 等 section 下的 key。常见错误是把配置写在了错误 section 或拼错了 key 名。
-
db_host、db_port、db_user、db_pass、db_name这些只是自定义 key,Beego ORM 并不直接识别——你得自己用beego.AppConfig.String("db_host")拼出连接串 - 真正被 ORM 识别的固定 key 是:
mysql、postgres、sqlite3,它们必须出现在[dev]下,且值为完整 DSN(Data Source Name) - 例如 MySQL 正确写法:
mysql = root:123456@tcp(127.0.0.1:3306)/test?charset=utf8mb4&loc=Local&parseTime=true
- SQLite3 则只需路径:
sqlite3 = database.db
代码里注册数据库的三步不能跳
即使 app.conf 配对了,不执行注册,orm.QueryTable 会 panic 报 no registered database。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
- 先调
orm.RegisterDriver("mysql", orm.DRMySQL)(驱动名和常量必须匹配) - 再调
orm.RegisterDataBase("default", "mysql", beego.AppConfig.String("mysql"))(第三个参数必须是从 app.conf 读出来的完整 DSN) - 最后在
main()或init()中加orm.RunSyncDB("default", false, true)(仅开发期建表用,生产环境应设为false)
ORM 自动建表失败的典型原因
运行 bee run 后模型没生成表,不是代码写错,大概率是配置链断在某个环节。
立即学习“go语言免费学习笔记(深入)”;
- 检查
conf/app.conf中runmode值是否和当前 section 一致(比如runmode = dev,但只写了[prod]) - 确认
orm.RegisterDataBase第二个参数(alias)和模型结构体上的// @router /user [get]注释无关,但和orm.NewOrm().Using("default")中的 alias 必须完全一致 - MySQL 用户权限不足时,
RunSyncDB不报错也不建表,需手动连库验证CREATE TABLE权限 - 字段 tag 写错会导致建表忽略该字段:
json:"name"不影响建表,但orm:"column(name)"拼错就失效
最易被忽略的是:Beego 的 ORM 初始化必须在 beego.Run() 之前完成,且不能放在 controller 的 Get() 方法里——那已经太晚了,连接池都还没建立。

















