beego orm 默认不自动生成表结构，因其设计上将模型注册与模式同步解耦，须显式调用 orm.runsyncdb 才建表；registermodel 仅注册元数据，不操作数据库，避免生产环境误改结构。
Beego ORM 为什么默认不自动生成表结构
Beego 的 orm.RegisterModel 只注册模型定义，不触发建表；它依赖显式调用 orm.RunSyncdb 才会操作数据库。很多新手在 main.go 或 router.go 里注册完模型就以为表会自动创建，结果连 SELECT 都报 table doesn't exist 错误。
根本原因：Beego ORM 设计上把“模型注册”和“模式同步”解耦，避免服务启动时意外修改生产库结构。
-
orm.RegisterModel必须在orm.RunSyncdb之前调用，否则无模型可同步 - 只对尚未存在的表执行
CREATE TABLE，已存在表默认跳过（除非传force参数） - 不支持增量字段变更（比如新增一个
string字段），force=true会先DROP再重建，清空数据
如何安全调用 RunSyncdb 创建表
最稳妥的位置是在应用初始化完成、数据库连接已建立之后，且仅在开发/测试环境启用。别在生产环境代码里留着 RunSyncdb 调用。
典型写法（放在 main.go 中）：
func main() {
beego.Run()
// 注意：必须在 beego.Run() 之后，确保配置已加载、DB 已注册
if beego.AppConfig.String("runmode") == "dev" {
orm.RunSyncdb("default", false, true) // 第三个参数 true 表示 force
}
}
- 第一个参数
"default"是数据库 alias，需与app.conf中db.default.*配置一致 - 第二个参数
false表示不打印 SQL 日志（设为true可调试建表语句） - 第三个参数
true表示强制重建（开发时常用），生产环境务必设为false - 如果使用 MySQL，需确保用户有
CREATE权限；SQLite 会自动建文件和表
模型定义中哪些 tag 会影响生成的字段
Beego ORM 通过结构体 tag 控制建表细节，不是所有字段都会原样映射。忽略关键 tag 容易导致类型不符或约束缺失。
-
orm:"pk"—— 标记主键，否则字段不会加PRIMARY KEY，且 Beego 默认要求主键名为Id -
orm:"auto"—— 对应INT AUTO_INCREMENT（MySQL）或SERIAL（PostgreSQL），仅对int类型主键有效 -
orm:"size(255)"—— 控制VARCHAR长度，不写则默认VARCHAR(255) -
orm:"null"—— 允许 NULL；不加则默认NOT NULL -
orm:"index"或orm:"unique"—— 分别生成普通索引或唯一索引
例如：UserName string `orm:"size(64);null;index"` 会生成 user_name VARCHAR(64) NULL INDEX 字段。
常见失败场景和排查方式
执行 RunSyncdb 后表没建出来？先看这几处：
- 日志是否输出
create table xxx？没输出说明RunSyncdb根本没执行（检查运行模式、调用位置） - 错误信息是
ERROR 1045 (28000): Access denied？数据库用户权限不足，至少需要CREATE和DESCRIBE - 错误是
unknown field type？结构体字段用了 Beego 不支持的类型（如time.Time必须配orm:"type(datetime)"） - 表名变成复数或加了下划线（如
user_infos）？Beego 默认开启复数化，可在main.go初始化时关闭：orm.DefaultPrefix = ""
真正麻烦的是跨环境一致性——开发机建的表结构，上线后因 MySQL 版本或 SQL mode 差异导致某些字段类型被静默转换（比如 TEXT 被转成 MEDIUMTEXT）。这类问题没法靠 RunSyncdb 发现，得靠导出 SQL 比对。
