数据库迁移指南

Flyway 版本化管理——迁移格式、执行命令、CI/CD 集成

Litopia 使用 Flyway 管理数据库迁移(版本化 + 追踪)。所有迁移文件位于 supabase/ 目录。

迁移格式

V1.0.x__action_object.sql

  • 示例:V1.0.15__create_update_profile_with_validation.sql
  • SQL 文件不使用中文(注释也用英文)
  • Cron 表达式必须使用 UTC 时区
  • 一个迁移文件 = 一个逻辑变更

常用命令

命令说明
npm run db:migrate执行所有未执行的迁移
npm run db:info查看迁移状态
npm run db:validate验证迁移文件完整性和一致性