Revel 项目没有自动 migration 命令,因其仅负责 Web 层和生命周期管理,不处理数据库 schema 变更;需借助 goose(SQL 优先)或 GORM AutoMigrate(仅限 dev),且所有路径必须基于 revel.AppPath 构建绝对路径。

Revel 项目里为什么没有自动 migration 命令
因为 Revel 本身不提供数据库迁移功能,它只负责 Web 层和生命周期管理,不介入 schema 变更。你执行 revel run 或 revel build 时,框架完全不会扫描 migrations/ 目录,也不会读取 conf/app.conf 里的 db.url 去做任何建表或版本升级操作。常见错误是以为配置了 db.import 就能触发迁移——其实那只是告诉 Revel 用哪个 driver 初始化连接池,跟 migration 毫无关系。
用 goose + GORM 组合做可落地的迁移流程
goose 是最轻量、SQL 优先、且与 Revel 解耦性最好的选择。它不依赖 Go struct,纯靠 SQL 文件版本控制,适合团队协作和生产发布。
- 在项目根目录新建
migrations/,文件命名必须带时间戳前缀,例如20230101120000_create_users_table.sql - SQL 文件里写标准 DDL,支持
-- +goose Up和-- +goose Down分段,goose 会按需执行对应块 - 开发阶段手动运行:
goose -dir migrations sqlite3 ./data/app.db up(SQLite)或goose -dir migrations mysql "user:pass@tcp(127.0.0.1:3306)/dbname" up - 生产部署时,把
goose二进制和migrations/一起打进镜像,在启动脚本里加一行:goose -dir ./migrations $DB_DRIVER "$DB_URL" up - 切勿在
app.Init()里调goose.Up()—— 这会让revel test失败,因为测试用的是内存 SQLite,不该被真实迁移污染
控制器里临时触发迁移(仅限 dev)
某些本地调试场景下,你想通过 HTTP 端点快速跑一次 AutoMigrate,这不是生产方案,但可以省去反复敲命令的麻烦。
- 路由中加:
GET /_migrate APP.Migrate,并在app.conf中限制仅run.mode=dev时启用 - 控制器方法里先判断环境:
if revel.RunMode != "dev" { return c.RenderError("Migration disabled") } - 然后调用 GORM 的
db.AutoMigrate(&User{}, &Post{}),注意:必须显式列出模型,不能传空结构体或用反射遍历 - 不要在事务内调
AutoMigrate,GORM 不支持在事务中建表;也不要对已存在字段做类型变更,AutoMigrate不会修改列定义
路径和配置一致性最容易被忽略
Revel 应用启动时工作目录不确定,./migrations 可能找不到。所有迁移工具调用都必须基于 revel.AppPath 构建绝对路径,否则 CI/CD 或容器环境下必失败。
- goose 命令中的
-dir参数不能写相对路径,应拼成:goose -dir $(revel.AppPath)/migrations ... - 如果用 GORM 的
AutoMigrate,模型文件路径也要用revel.AppPath加载 SQL 模板或 seed 数据 - SQLite 的 DB 文件路径同理:
file:$(revel.AppPath)/data/app.db,否则不同启动方式下数据库可能被创建在不同位置











