Flyway 是一个用于管理数据库结构变更的版本控制工具。它通过脚本文件记录数据库的每一次变更，确保在不同环境（开发、测试、生产）中数据库结构能一致、可靠地演进。
可以把数据库想象成一栋不断装修扩建的房子。Flyway 就像是这栋房子的施工蓝图文件夹，里面按日期和顺序存放着每一次装修的详细图纸。施工队（Flyway）严格按照图纸的顺序执行，确保每个人手中的房子最终结构完全相同。
1. 它是什么
Flyway 是一个数据库迁移（Database Migration）工具。核心思想是将数据库的结构变化（如表创建、字段增减、数据初始化）写成 SQL 脚本，并按照版本号顺序执行。Flyway 会在一个单独的表中（默认叫flyway_schema_history）记录哪些脚本已经执行过，从而避免重复执行，并确保脚本按顺序推进。
它就像一个严谨的档案管理员，负责登记和安排所有数据库的“变更申请单”。
2. 它能做什么
版本控制数据库：像 Git 管理代码一样，管理数据库结构的每个版本。
自动化部署：在应用启动时，或通过命令，自动将数据库升级到目标版本。
环境一致性：消除因手工执行 SQL 脚本导致的“在开发机正常，在生产环境出错”的问题。
回滚支持：通过编写“撤销迁移”的脚本（undo migration），或规划新的正向迁移来修复问题，实现回滚能力。
状态可视：清晰查看当前数据库的版本历史，以及是否有待执行的迁移。
例如，团队开发一个功能，需要新增一张user_profile表。开发者 A 在本地数据库手动创建了，但忘了告诉开发者 B。B 运行代码时就出错了。使用 Flyway 后，创建这张表的 SQL 会被写成迁移脚本，提交到代码库。B 更新代码后，启动项目时 Flyway 会自动为他创建这张表，问题得以解决。
3. 怎么使用
在 Flask 项目中，通常不直接使用 Flyway 的原生 Java 命令行工具，而是使用其核心的迁移理念，或者借助适合 Python 生态的类似工具（如 Alembic）。但使用模式是相通的，基本流程如下：
创建迁移脚本：在项目中建立一个目录（如
migrations/），用于存放 SQL 文件。文件命名有严格约定，例如V1__Create_user_table.sql，V2__Add_email_to_user.sql。前缀V表示版本，后面跟版本号、双下划线和描述。编写 SQL：在文件里编写纯粹的、幂等的 SQL 语句。对于
V1__.sql，可能就是CREATE TABLE user (...) ;。配置与执行：
独立运行：通过 Flyway 的命令行工具，指定数据库连接信息和迁移脚本位置，执行
flyway migrate。集成启动：在 Flask 应用启动前，调用 Flyway API 或使用插件，自动检查并执行未应用的迁移。
查看状态：通过
flyway info命令或查询flyway_schema_history表，了解迁移历史。
一个简化的过程类似于：你写好了一份份菜谱（SQL脚本），交给一个自动厨师（Flyway）。厨师会先看厨房的记录本（schema history），发现还没做过“第3号菜”（V3），然后就严格按照你的第3号菜谱开始烹饪。
4. 最佳实践
脚本幂等性：每个迁移脚本应可重复执行而不出错。使用
CREATE TABLE IF NOT EXISTS或ALTER TABLE前先判断字段是否存在等写法。或者依赖 Flyway 的版本控制来保证绝不重复执行。小步快跑：每次迁移只做一个小的、独立的变更。不要在一个脚本里混合创建表、修改字段、初始化数据等多件不相关的事。这利于定位问题和回滚。
版本命名清晰：使用有意义的描述，如
V20240701_1030__Add_payment_status_column.sql。时间戳常被用作版本号以保证顺序。将脚本纳入版本控制：迁移脚本必须和应用程序代码一起，使用 Git 等工具进行管理。
分离数据迁移与结构迁移：初始化基础数据（如国家列表）可以放在迁移脚本中，但大量业务数据应使用其他方式同步。避免在结构迁移脚本中进行复杂的数据转换。
在生成环境前充分测试：一定要在和生产环境相似的测试环境，从头（空数据库）执行所有迁移脚本，验证其正确性。
回滚策略：优先考虑编写新的正向迁移来修复问题。如果需要“撤销迁移”功能，需额外维护一组降级脚本（downward script），这会增加复杂度。
5. 和同类技术对比
在 Python/Flask 生态中，Flyway 的主要对等物是Alembic。
| 特性 | Flyway | Alembic (常用于SQLAlchemy) |
|---|---|---|
| 核心语言 | Java，但通过命令行或驱动可用于任何环境 | Python |
| 脚本语言 | 纯 SQL或 Java-based | 纯 SQL或Python代码（Op） |
| 与ORM集成 | 无绑定，数据库为中心 | 与 SQLAlchemy 深度集成，是其官方迁移工具 |
| 使用方式 | 声明式。直接写最终SQL。 | 可声明式（生成SQL），也可操作式（用Python API描述变更）。 |
| 优势 | 简单、直接、强制规范。适合喜欢或需要直接控制SQL的团队。与语言无关，多技术栈项目统一。 | 与SQLAlchemy模型定义联动紧密，可自动生成迁移脚本。利用Python的灵活性处理复杂数据迁移。 |
| 劣势 | 在Python项目中需额外维护命令行工具或集成。对模型定义变更的自动化支持较弱。 | 自动生成可能不完美，需要人工审查。对非SQLAlchemy或不使用ORM的项目不适用。 |
选择建议：
如果你的 Flask 项目重度使用 SQLAlchemy ORM，希望迁移能自动从模型定义中生成，Alembic 是自然且强大的选择。
如果你的项目使用原生 SQL、其他ORM，或是多语言技术栈（如Java服务也用同一个数据库），希望有一个统一、简单、以SQL为中心的工具，Flyway 是更通用的选择。
两者核心思想一致，都能很好地解决数据库迁移的问题。区别主要在于与特定框架的集成度和脚本编写方式。
技术白皮书（上篇）)
技术白皮书（下篇）)
