本文详解 Beego 的数据库迁移机制，涵盖迁移文件生成、SQL 脚本编写（如添加字段）、Up/Down 逻辑实现，以及通过 bee migrate 命令安全执行与回滚，助你规范化管理数据库结构演进。
本文详解 beego 的数据库迁移机制，涵盖迁移文件生成、sql 脚本编写（如添加字段）、up/down 逻辑实现，以及通过 `bee migrate` 命令安全执行与回滚，助你规范化管理数据库结构演进。
Beego 自带轻量但实用的数据库迁移能力，虽不如 Django South 或 GORM AutoMigrate 那样自动化建模，但通过 bee 工具链可实现可控、可追溯的 SQL 级结构变更。其核心流程分为三步：生成迁移骨架 → 编写变更逻辑 → 执行迁移命令，全程无需手动维护版本状态表（Beego 内部通过文件名时间戳和注册机制自动追踪已执行迁移）。
✅ 第一步：生成迁移文件
使用 bee generate migration 创建带时间戳的迁移脚本（推荐使用语义化名称，如 add_age_to_user）：
bee generate migration add_age_to_user
执行后，Beego 将在 database/migrations/ 目录下生成类似 20240515_103022_add_age_to_user.go 的文件，内容结构如下：
package main
import (
"github.com/astaxie/beego/migration"
)
// DO NOT MODIFY
type AddAgeToUser_20240515_103022 struct {
migration.Migration
}
// DO NOT MODIFY
func init() {
m := &AddAgeToUser_20240515_103022{}
m.Created = "20240515_103022"
migration.Register("AddAgeToUser_20240515_103022", m)
}
// Run the migrations
func (m *AddAgeToUser_20240515_103022) Up() {
// ? 在此处编写正向变更 SQL（例如为 users 表添加 age 字段）
m.SQL("ALTER TABLE users ADD COLUMN age INT DEFAULT 0 COMMENT '用户年龄'")
}
// Reverse the migrations
func (m *AddAgeToUser_20240515_103022) Down() {
// ? 对应的逆向操作（务必保证幂等且安全）
m.SQL("ALTER TABLE users DROP COLUMN age")
}⚠️ 注意事项：
- Up() 和 Down() 中必须使用 m.SQL() 执行原生 SQL；Beego 不提供 DSL 或模型抽象层，所有 DDL/DML 需自行编写并确保兼容目标数据库（如 MySQL、PostgreSQL）。
- Down() 应具备真正的可逆性：避免 DROP COLUMN 后无法恢复数据；生产环境建议先备份再执行回滚。
- 迁移文件名中的时间戳（如 20240515_103022）是 Beego 排序与去重的关键依据，切勿手动修改。
✅ 第二步：执行迁移
运行 bee migrate 并传入数据库连接字符串（支持 MySQL、PostgreSQL、SQLite3）：
# MySQL 示例 bee migrate -conn="root:password@tcp(127.0.0.1:3306)/myapp?charset=utf8mb4&parseTime=True" # PostgreSQL 示例 bee migrate -conn="user=postgres password=123456 dbname=myapp sslmode=disable" # SQLite3 示例（路径需为绝对路径） bee migrate -conn="/absolute/path/to/app.db"
Beego 会自动扫描 database/migrations/ 下所有未执行的迁移文件（按 Created 时间升序），依次调用其 Up() 方法，并将执行记录写入数据库的 migration_log 表（首次运行时自动创建）。
✅ 第三步：验证与维护
- 查看迁移状态：bee migrate -status 可列出已执行/待执行的迁移项；
- 回滚单步迁移：bee migrate -rollback=1（回退最近一次）或指定迁移名 bee migrate -rollback=AddAgeToUser_20240515_103022；
- 生产部署前，务必在测试环境完整走通 Up → Down → Up 流程，验证双向逻辑正确性；
- 建议将迁移文件纳入 Git 版本控制，并在团队内约定命名规范（如 add_xxx_to_yyy / remove_zzz_from_abc），提升协作可读性。
Beego 的迁移方案简洁务实——它不隐藏 SQL 复杂性，而是将控制权交还开发者。只要遵循“每个迁移专注单一职责”“Up/Down 成对设计”“连接参数环境隔离”三大原则，即可稳健支撑从开发到上线的全周期数据库演进。
